定制 hitmeister/suppliers-api-sdk 二次开发

按需修改功能、优化性能、对接业务系统,提供一站式技术支持

邮箱:yvsm@zunyunkeji.com | QQ:316430983 | 微信:yvsm316

hitmeister/suppliers-api-sdk

Composer 安装命令:

composer require hitmeister/suppliers-api-sdk

包简介

Suppliers API SDK

README 文档

README

This documentation describes SMS Suppliers API. To be able use this API you should have an api-key and api-username

This PHP package is automatically generated by the Swagger Codegen project:

  • API versions: 1.11.1 & 2.0.0
  • Package version: 0.15.1
  • Build package: com.kaufland.swagger.codegen.CustomPhpClientCodegen

API versions

This SDK provides a way to communicate with both v1 AND v2 Suppliers APIs (see specific versions above). By default, version 1 is used. To change it, please use SMS\Suppliers\Configuration::getDefaultConfiguration()->setApiVersion($apiVersion) to set the API version (1 or 2) and make sure you then use the classes with the correct namespace to create your requests. Using a class of the wrong version could cause unexpected behaviour.

Ex: SMS\Suppliers\Api\InventoryApi for version 1 and SMS\Suppliers\Api\v2\InventoryApi for version 2

Older implementations of this SDK don't need to be changed for version 1.

Requirements

PHP 5.5 and later

Installation & Usage

Composer

To install the bindings via Composer, add the following to composer.json:

{
  "repositories": [
    {
      "type": "git",
      "url": "https://github.com/hitmeister/suppliers-api-sdk.git"
    }
  ],
  "require": {
    "hitmeister/suppliers-api-sdk": "*@dev"
  }
}

Then run composer install

Manual Installation

Download the files and include autoload.php:

    require_once('/path/to/suppliers-api-sdk/vendor/autoload.php');

Tests

To run the unit tests:

composer install
./vendor/bin/phpunit

Getting Started

Please follow the installation procedure and then run the following:

<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apiKey
$config = SMS\Suppliers\Configuration::getDefaultConfiguration()->setApiKey('api-key', 'YOUR_PARAMETER_VALUE');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// $config = SMS\Suppliers\Configuration::getDefaultConfiguration()->setApiKeyPrefix('api-key', 'Bearer');
// Configure API key authorization: apiUsername
$config = SMS\Suppliers\Configuration::getDefaultConfiguration()->setApiKey('api-username', 'YOUR_PARAMETER_VALUE');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// $config = SMS\Suppliers\Configuration::getDefaultConfiguration()->setApiKeyPrefix('api-username', 'Bearer');
// Set API version (1 or 2)
$config = SMS\Suppliers\Configuration::getDefaultConfiguration()->setApiVersion(1);

$apiInstance = new SMS\Suppliers\Api\InventoryApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$id = "id_example"; // string | ID of inventory
$body = new \SMS\Suppliers\Model\CreateImportRequest(); // \SMS\Suppliers\Model\CreateImportRequest | Inventory import request which stores all the necessary info

try {
    $apiInstance->createImportRequest($id, $body);
} catch (Exception $e) {
    echo 'Exception when calling InventoryApi->createImportRequest: ', $e->getMessage(), PHP_EOL;
}

?>

Documentation for API Version 1

Endpoints

All URIs are relative to https://sms.kaufland.de/api/v1/supplier

Class Method HTTP request Description
InventoryApi createImportRequest POST /inventories/{id}/import-requests Create new inventory import
InventoryApi getInventory GET /inventories/{id} Find inventory by ID
InventoryUnitApi createInventoryUnit POST /inventory-units Create new inventory unit
InventoryUnitApi deleteInventoryUnit DELETE /inventory-units/{id} Delete inventory unit by supplier_item_id
InventoryUnitApi getInventoryUnit GET /inventory-units/{id} Find inventory unit by supplier_item_id
InventoryUnitApi getInventoryUnits GET /inventory-units Find all inventory units
InventoryUnitApi updateInventoryUnit PATCH /inventory-units/{id} Update inventory unit
ItemMeasurementApi createItemMeasurement POST /item-measurements Create item-measurement by gtin (for crossdock & wholesaler)
ItemMeasurementApi getItemMeasurement GET /item-measurements/{gtin} Find item-measurement by gtin
OrderApi confirmOrder POST /orders/{id}/confirm Confirm order
OrderApi getOrder GET /orders/{id} Find order by ID
OrderApi getOrders GET /orders Find all orders by given parameters
OrderUnitApi cancelOrderUnit POST /order-units/{id}/cancel Cancel an order unit
OrderUnitApi getOrderUnit GET /order-units/{id} Find order unit by ID
OrderUnitApi pickOrderUnit POST /order-units/{id}/pick Change order unit status to 'picking'
OrderUnitApi sendOrderUnit POST /order-units/{id}/send Send an order unit
OrderUnitApi updateOrderUnitShipment POST /order-units/{id}/shipment Update shipment data of the order unit
SubscriptionApi createSubscription POST /subscriptions Create new subscription
SubscriptionApi deleteSubscription DELETE /subscriptions/{id} Delete existing subscription
SubscriptionApi updateSubscription PATCH /subscriptions/{id} Update existing subscription
SubscriptionApi viewSubscription GET /subscriptions/{id} View existing subscription
SubscriptionApi viewSubscriptions GET /subscriptions Get all existing subscriptions

Models

Documentation for API Version 2

Endpoints

All URIs are relative to https://sms.kaufland.de/api/v2/supplier

Class Method HTTP request Description
InventoryApi createImportRequest POST /inventories/{id}/import-requests Create new inventory import
InventoryApi getInventory GET /inventories/{id} Find inventory by ID
InventoryUnitApi createInventoryUnit POST /inventory-units Create new inventory unit
InventoryUnitApi deleteInventoryUnit DELETE /inventory-units/{id} Delete inventory unit by supplier_item_id
InventoryUnitApi getInventoryUnit GET /inventory-units/{id} Find inventory unit by supplier_item_id
InventoryUnitApi getInventoryUnits GET /inventory-units Find all inventory units
InventoryUnitApi updateInventoryUnit PATCH /inventory-units/{id} Update inventory unit
ItemMeasurementApi createItemMeasurement POST /item-measurements Create item-measurement by gtin (for crossdock & wholesaler)
ItemMeasurementApi getItemMeasurement GET /item-measurements/{gtin} Find item-measurement by gtin
OrderApi confirmOrder POST /orders/{id}/confirm Confirm order
OrderApi getOrder GET /orders/{id} Find order by ID
OrderApi getOrders GET /orders Find all orders by given parameters
OrderUnitApi cancelOrderUnit POST /order-units/{id}/cancel Cancel an order unit
OrderUnitApi getOrderUnit GET /order-units/{id} Find order unit by ID
OrderUnitApi pickOrderUnit POST /order-units/{id}/pick Change order unit status to 'picking'
OrderUnitApi sendOrderUnit POST /order-units/{id}/send Send an order unit
OrderUnitApi updateOrderUnitShipment POST /order-units/{id}/shipment Update shipment data of the order unit
SubscriptionApi createSubscription POST /subscriptions Create new subscription
SubscriptionApi deleteSubscription DELETE /subscriptions/{id} Delete existing subscription
SubscriptionApi updateSubscription PATCH /subscriptions/{id} Update existing subscription
SubscriptionApi viewSubscription GET /subscriptions/{id} View existing subscription
SubscriptionApi viewSubscriptions GET /subscriptions Get all existing subscriptions

Models

Documentation For Authorization

apiKey

  • Type: API key
  • API key parameter name: api-key
  • Location: HTTP header

apiUsername

  • Type: API key
  • API key parameter name: api-username
  • Location: HTTP header

Author

sms.tech@kaufland-online.com

hitmeister/suppliers-api-sdk 适用场景与选型建议

hitmeister/suppliers-api-sdk 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 47.19k 次下载、GitHub Stars 达 1, 最近一次更新时间为 2017 年 08 月 03 日, 在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向: 「php」 「api」 「sdk」 「swagger」 「real.digital」 「sms.real」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 hitmeister/suppliers-api-sdk 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。

围绕 hitmeister/suppliers-api-sdk 我们能提供哪些服务?
定制开发 / 二次开发

基于 hitmeister/suppliers-api-sdk 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ:316430983 微信:yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

统计信息

  • 总下载量: 47.19k
  • 月度下载量: 0
  • 日度下载量: 0
  • 收藏数: 1
  • 点击次数: 3
  • 依赖项目数: 0
  • 推荐数: 0

GitHub 信息

  • Stars: 1
  • Watchers: 7
  • Forks: 4
  • 开发语言: PHP

其他信息

  • 授权协议: MIT
  • 更新时间: 2017-08-03