API

签名算法

    /**
     * @param array $data
     * @param string $secret
     * @return string
     */
    public static function generateSignature(array $data, string $secret): string
    {
        unset($data['sign']);
        ksort($data);
        foreach ($data as $key => $val) {
            if ($val === '' || is_array($val)) {
                unset($data[$key]);
            }
        }
        return md5(urldecode(http_build_query($data) . "&key=" . (string)$secret));
    }

公共请求头

参数名称	必选	类型	说明
Api-Id	是	string	会员ID，在会员中心，我的资料中可以获得
Api-Signature	是	string	数据签名，将POST所有参数，通过上方的签名算法进行签名，然后可以得到此签名字符串，其中$secret数，就是API密钥，也是在我的资料中获得

获取全部货源列表

POST /plugin/open-api/items

单独获取某个商货源信息

POST /plugin/open-api/item

• Body参数

参数名称	必选	类型	说明
id	是	int	货源ID

获取SKU库存数量

POST /plugin/open-api/sku/stock

• Body参数

参数名称	必选	类型	说明
sku_id	是	int	货源下的SKU ID

获取SKU当前状态，判断当前SKU是否可以进行购买

POST /plugin/open-api/sku/state

• Body参数

参数名称	必选	类型	说明
sku_id	是	int	货源下的SKU ID
quantity	是	int	需购买的数量

下单（进货）

POST /plugin/open-api/trade

• Body参数

参数名称	必选	类型	说明
sku_id	是	int	货源下的SKU ID
quantity	是	int	需购买的数量
trade_no	是	string	24位数字订单号，必须是24位
async_url	否	string	异步通知地址

值得注意的是，拉取货源时，需要在意控件，控件的name，就是参数名称，一起提交到此接口即可

订单查询

POST /plugin/open-api/query

• Body参数

参数名称	必选	类型	说明
trade_no	是	string	24位数字订单号，必须是24位

异步通知

通过下单接口传递的async_url异步通知地址，当订单状态发生变化，会通知此地址

请求头

参数名称	类型	说明
Api-Signature	string	在进行异步通知时，会将签名参数携带到header头中

POST数据

参数名称	类型	说明
status	int	订单状态：状态：0=等待发货，1=已发货，2=发货失败，3=已退款
contents	string	发货内容
item_trade_no	string	三方订单号，也就是你自己平台的订单号
trade_no	string	系统订单号，上游平台订单号
amount	string	金额
trade_time	string	交易时间