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

交易时间

最后更新于