Formato de respuesta
Cómo SP-API devuelve headers de respuesta y mensajes.
En respuesta a una solicitud HTTP, la API del selling partner devuelve response headers y un mensaje de response JSON.
La siguiente tabla enumera los headers de respuesta que puede recibir. Los headers reales que reciba dependerán de la sección y la operación específicas de la API.
Response headers
| Nombre | Descripción | Ejemplo |
|---|---|---|
| Connection | Valor predeterminado keep-alive para una conexión persistente con el cliente. | Connection: keep-alive |
| Content-Length | Standard HTTP response header. | Content-Length: 624 |
| Content-Type | Standard HTTP response header. | Content-Type: application/json |
| Date | Standard HTTP response header. | Date: Fri, 17 Feb 2023 20:13:55 GMT |
| x-amz-apigw-id | ID de solicitud extendida creada por APIGateway. Este header es opcional y no se puede devolver. | x-amz-apigw-id: Ac1E1EycvHcFyNw= |
| x-amzn-ErrorType | APIGateway completa este error con el errorType si el response status code es 4xx o 5xx. Este header es opcional y no se puede devolver. | x-amzn-ErrorType: AccessDeniedException |
| x-amzn-RateLimit-Limit | Devuelve el rate limit aplicado a la solicitud. Este header se devuelve según el mejor esfuerzo y solo para HTTP responses específicas. Consulte Planes de uso y límites de tarifas en SP-API para obtener más información. | x-amzn-RateLimit-Limit: 2.0 |
| x-amzn-RequestId | Solicitar identificador. Proporcione esto si se comunica con nosotros para obtener asistencia. | x-amzn-RequestId: 6875f61f-6aa1-11e8-98c6-9bExample |
| X-Amzn-Trace-Id | Un identificador de seguimiento generado por APIGateway. Este header es opcional y no se puede devolver. | X-Amzn-Trace-Id: Root=1-63ee9bb8-52ea8e6d108209842abc2a4d |
Respuesta de éxito
Si su solicitud tiene éxito, la Selling Partner API devuelve los datos solicitados. Aquí hay un ejemplo de una respuesta exitosa.
HTTP/1.1 200 OK
Content-Length: 368
Content-Type: application/json
Date: Thu, 01 Jun 2020 22:23:31 GMT
x-amzn-RequestId: 6875f61f-6aa1-11e8-98c6-9bExample
{
"payload": {
"ConfirmedNeedByDate": "2020-04-23",
"ConfirmedFulfillableDate": "2020-04-23"
}
}
Respuesta de error
Si su solicitud no tiene éxito, la Selling Partner API devuelve una respuesta de error. Estos son los elementos del mensaje de respuesta en una respuesta de error:
mensaje de respuesta
| Elemento | Descripción | Requerido |
|---|---|---|
| code | HTTP status code. | Sí |
| message | Explicación de la condición de error. | Sí |
| details | Link a información adicional. | No |
Este es un ejemplo de una respuesta de error:
HTTP/1.1 400 Bad Request
Content-Length: 117
Content-Type: application/json
Date: Fri, 01 Jun 2020 21:48:02 GMT
x-amzn-ErrorType: ValidationException
x-amzn-RequestId: a8c8d99a-6ab5-11e8-b0f8-19363980175b
{
"errors": [
{
"message": "Access to requested resource is denied.",
"code": "Unauthorized",
"details": "Access token is missing in the request header."
}
]
}
Updated over 1 year ago