Use HTTP request API

API call process

API call request address

The PandaPon global open platform provides a set of online production environment. The data generated in this environment is real and effective online data. The request address is as follows.

API request address: https://api.pandapon.com

Request and response

PandaPon Global Open Platform API supports HTTP and HTTPS communication protocols at the same time. In order to ensure data security, it is recommended to use the HTTPS protocol to issue API requests.

All API requests return a response result, which shows the returned status (success or error), and may provide results or detailed data related to the specified request. The returned data format is JSON.

Request parameters

The request parameters of all APIs include two parts: system parameters and business parameters.

System parameters

All API requests require the following system parameters, see the following table for details

Name	Type	Is it necessary	is it used as a sign parameter	Description
access-key	String	Yes	Yes	AccessKey assigned by PandaPon to developers
timestamp	String	Yes	Yes	Request sending time, please use the UTC timestamp, and note that the request time and UTC time should not exceed 600 seconds
nonce-str	String	Yes	Yes	Random string 32 bits
user-id	String	Yes	No	Used for sub-account permission control
signature	String	Yes	No	Interface signature, which is used to verify the legality of the request. For specific rules, please refer to the parameter signature

It should be noted that all system parameters must be stored in the HTTP header request header。

Business parameters

In addition to the system parameters that must be included, all API requests must contain their corresponding business parameters，For details of the business parameters of each API, please refer to API reference。

Request response

The request response data format of all APIs is JSON, and the format reference is as follows:

Name	Type	Description
requestId	String	Request id, you can query the corresponding log according to the request id
code	Integer	Return code
developId	String	Developer id
msg	String	Return code corresponding information
data	Object	Return to the content

请求响应样例：

{
    "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": "参考身高"
                    }
                ]
            }
        ]
    }
}

Parameter signature

The PandaPon global open platform will verify the identity of each API request, and the server will also verify whether the request parameters are valid. Therefore, each HTTP request must contain signature data, and requests with invalid signatures will be rejected.

The PandaPon global open platform verifies the identity of the request through AccessKey and the key (AccessSecret) assigned to the developer. The key (AccessSecret) is used to generate a signature string when requesting HTTP. Please keep your key (AccessSecret) strictly confidential.

The process of generating signatures is as follows:

Step 1: Directly splice the public request parameters according to 'access-key', 'timestamp', 'nonce_str', 'authorization secret key';

Step 2: Stitch the string completed in the first step and encrypt it through md5;

Step 3: Convert all the encrypted strings into capital letters to get the final signature.

JAVA sample code：

PHP sample code

Development manual

Use HTTP request API#

API call process#

API call request address#

Request and response#

Request parameters#

System parameters#

Business parameters#

Request response#

Parameter signature#