使用HTTP请求API

API调用流程

API调用请求地址

PandaPon全球开放平台提供了一套线上生产环境，在该环境下产生的数据都是真实有效的线上数据，请求地址如下

API请求地址: https://api.pandapon.com

请求与响应

PandaPon全球开放平台 API 同时支持 HTTP 和 HTTPS 通信协议。为了确保资料安全性，建议使用 HTTPS 协议发出 API 请求。

所有 API 请求都返回一个响应结果，该响应结果显示返回的状态（成功或错误），以及可能提供与指定请求相关的结果或详细数据，返回的数据格式是JSON。

请求参数

所有 API 的请求参数包含系统参数和业务参数两部分。

系统参数

所有 API 请求都需要以下系统参数，详见下表：

名称	类型	是否必须	是否作为sign参数	描述
access-key	String	是	是	PandaPon分配给开发者的AccessKey
timestamp	String	是	是	请求发送时间，请使用UTC时间戳，注意请求时间与UTC时间不得超过600秒
nonce-str	String	是	是	随机字符串32位
user-id	String	是	否	用于子账号权限控制
signature	String	是	否	接口签名，用于验证请求合法性，具体规则详见参数签名

需要注意的是所有系统参数必须存放于 HTTP header 请求头中 。

业务参数

除了必须包含的系统参数之外，所有 API 请求都必须包含其对应的业务参数，每个 API 的业务参数详见API 参考。

请求响应

所有 API 的请求响应数据格式为JSON，格式参考如下：

名称	类型	描述
requestId	String	请求id，可根据请求id查询对应日志
code	Integer	返回码
developId	String	开发者id
msg	String	返回码对应信息
data	Object	返回内容

请求响应样例：

{
    "requestId": "4cfda0b725184ab8a1e3ee3b9051ec35",
    "code": 200,
    "developId": "1014533973088404335",
    "msg": "成功",
    "data": {
        "quantity": 400,
        "categoryPath": "童装/婴儿装/亲子装->裙子(新)->连衣裙",
        "shopName": "u[2206891060210]",
        "description": "测试",
        "productUnit": null,
        "picUrls": [
            "https://img.alicdn.com/bao/uploaded/i1/263669477/O1CN01fH0cbf2JsW8fvHFwx_!!263669477.jpg"
        ],
        "title": "天穹发布商品，测试请不要拍",
        "mpId": "2048057995392326",
        "categoryName": "连衣裙",
        "itemId": 672991141190,
        "userNick": "测试账号tbc003",
        "price": 1,
        "beginAmount": 0,
        "status": "active",
        "promotionPrice": 1,
        "shopId": 268763467,
        "categoryId": "121452038",
        "itemType": "HAVE_MATERIAL",
        "skuList": [
            {
                "picUrl": null,
                "quantity": 200,
                "price": 1,
                "skuId": "3452545926724",
                "status": "active",
                "promotionPrice": "1",
                "postFee": 0,
                "mpSkuld": null,
                "properties": [
                    {
                        "valueId": 28326,
                        "valueName": "红色",
                        "propId": 1627207,
                        "propName": "颜色分类"
                    },
                    {
                        "valueId": 3273546,
                        "valueName": "52cm",
                        "propId": 122216343,
                        "propName": "参考身高"
                    }
                ]
            },
            {
                "picUrl": null,
                "quantity": 200,
                "price": 1,
                "skuId": "3452545926725",
                "status": "active",
                "promotionPrice": "1",
                "postFee": 0,
                "mpSkuld": null,
                "properties": [
                    {
                        "valueId": 28324,
                        "valueName": "黄色",
                        "propId": 1627207,
                        "propName": "颜色分类"
                    },
                    {
                        "valueId": 3273546,
                        "valueName": "52cm",
                        "propId": 122216343,
                        "propName": "参考身高"
                    }
                ]
            }
        ]
    }
}

参数签名

PandaPon全球开放平台会对每个 API 请求的身份进行验证，服务器也将验证请求参数是否有效。因此，每个 HTTP 请求必须包含签名数据，签名无效的请求将被拒绝。

PandaPon全球开放平台通过 AccessKey 和分配给开发者的密钥（AccessSecret）来验证请求的身份。密钥（AccessSecret）用于在 HTTP 请求时生成签名字符串，请严格保密您的密钥（AccessSecret）。

生成签名的过程如下：
第一步：将公共请求参数按‘access-key’，'timestamp'，'nonce_str'，'授权秘钥' 直接拼接;
第二步：将第一步拼接完成的字符串，通过md5加密；
第三步：将加密所得的字符串全部转换成大写字母，得出最终签名(sign)。

JAVA 示例代码：

PHP 示例代码

开发手册

使用HTTP请求API#

API调用流程#

API调用请求地址#

请求与响应#

请求参数#

系统参数#

业务参数#

请求响应#

参数签名#