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
- BadRequestResponse
- CancelOrderUnitRequest
- Carrier
- CarrierService
- CreateImportRequest
- CreateInventoryUnitRequest
- CreateInventoryUnitResponse
- CreateItemMeasurementRequest
- CreateSubscriptionRequest
- CreateSubscriptionResponse
- GetFulfilmentOrderResponse
- GetFulfilmentOrderUnitResponse
- GetFulfilmentOrdersResponse
- GetInventoryResponse
- GetInventoryUnitResponse
- Item
- ItemMeasurementResponse
- SendOrderUnitRequest
- ShipmentAddress
- ShipmentData
- UpdateInventoryUnitRequest
- UpdateOrderUnitShipmentDataRequest
- UpdateSubscriptionRequest
- UpdateSubscriptionResponse
- User
- ViewSubscriptionResponse
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
- BadRequestResponse
- CancelOrderUnitRequest
- Carrier
- CarrierService
- CreateImportRequest
- CreateInventoryCountryValuesRequest
- CreateInventoryUnitRequest
- CreateInventoryUnitResponse
- CreateItemMeasurementRequest
- CreateSubscriptionRequest
- CreateSubscriptionResponse
- GetFulfilmentOrderResponse
- GetFulfilmentOrderUnitResponse
- GetFulfilmentOrdersResponse
- GetInventoryResponse
- GetInventoryUnitCountryValueResponse
- GetInventoryUnitResponse
- Item
- ItemMeasurementResponse
- SendOrderUnitRequest
- ShipmentAddress
- ShipmentData
- UpdateInventoryCountryValuesRequest
- UpdateInventoryUnitRequest
- UpdateOrderUnitShipmentDataRequest
- UpdateSubscriptionRequest
- UpdateSubscriptionResponse
- User
- ViewSubscriptionResponse
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
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 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 hitmeister/suppliers-api-sdk 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
A PSR-7 compatible library for making CRUD API endpoints
Alfabank REST API integration
Zero-dependency raw PHP DNS resolver, domain-ownership verification, and intoDNS/MxToolbox-style diagnostics. Queries authoritative nameservers directly over sockets — never trusts the recursive cache for ownership checks.
A lightweight plain-PHP framework for database-backed CRUD APIs.
bughq error tracking - PHP SDK
ABsurge PHP SDK for feature flags and A/B testing
统计信息
- 总下载量: 47.19k
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 1
- 点击次数: 3
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2017-08-03