Usar la API de solicitud HTTP

Proceso de llamada API

Dirección de solicitud de llamada API

La plataforma abierta global PandaPon proporciona un conjunto de entorno de producción en línea. Los datos generados en este entorno son datos en línea reales y efectivos. La dirección de la solicitud es la siguiente.

Dirección de solicitud de API: https://api.pandapon.com

Solicitud y respuesta

PandaPon Global Open Platform API admite protocolos de comunicación HTTP y HTTPS al mismo tiempo. Para garantizar la seguridad de los datos, se recomienda utilizar el protocolo HTTPS para emitir solicitudes de API.

Todas las solicitudes de API devuelven un resultado de respuesta, que muestra el estado devuelto (éxito o error), y pueden proporcionar resultados o datos detallados relacionados con la solicitud especificada. El formato de datos devuelto es JSON.

Parámetros de solicitud

Los parámetros de solicitud de todas las API incluyen dos partes: parámetros del sistema y parámetros de negocio.

Parámetros del sistema

Todas las solicitudes de API requieren los siguientes parámetros del sistema, consulte la siguiente tabla para obtener más detalles

nombre	tipo	si es necesario	* * si se utiliza como parámetro simbólico *	descripción
clave de acceso	String	Sí	Sí	AccessKey asignada por PandaPon a los desarrolladores
timestamp	String	Sí	Sí	Solicite la hora de envío, por favor use la marca de tiempo UTC, y tenga en cuenta que la hora de solicitud y la hora UTC no deben exceder de 600 segundos
nonce-str	String	Sí	Sí	Cadena aleatoria de 32 bits
user-id	String	Sí	No	Usado para el control de permisos de subcuentas
firma	String	Sí	No	Firma de la interfaz, que se utiliza para verificar la legalidad de la solicitud. Para reglas específicas, consulte la firma del parámetro

Cabe señalar que todos los parametros del sistema deben almacenarse en el encabezado de solicitud de encabezado HTTP。

Parámetros de negocio

Además de los pámetros del sistema que deben incluirse, todas las solicitudes de API deben contener sus correspondientes parámetros comerciales, para obtener detalles de los parámetros comerciales de cada API, consulte Referencia de API。

Solicitud de respuesta

El formato de datos de respuesta de solicitud de todas las API es JSON, y la referencia de formato es la siguiente:

Nombre	Tipo	Descripción
requestId	String	Request id, puede consultar el registro correspondiente según el id de la solicitud
código	entero	código de devolución
developId	String	ID del desarrollador
msg	String	Devuelve la información correspondiente al código
datos	Objeto	Volver al contenido

请求响应样例：

{
    "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

Manual de desarrollo

Usar la API de solicitud HTTP#

Proceso de llamada API#

Dirección de solicitud de llamada API#

Solicitud y respuesta#

Parámetros de solicitud#

Parámetros del sistema#

Parámetros de negocio#

Solicitud de respuesta#

Parameter signature#