Autenticación y encabezados
Cada solicitud se autentica con tu clave de API, que se envía en el encabezado apikey. Estos son los encabezados que usa la API; aplican a todos los endpoints de este documento:
| Encabezado | Valor | Obligatorio | Descripción |
|---|---|---|---|
| apikey | Tu clave de API | Sí | Identifica y autentica a tu comercio. |
| X-VERSION | 1 | Sí | Versión de la API. |
| Content-Type | application/json | En solicitudes con cuerpo | Necesario en los POST que envían JSON. |
| X-TRACE-ID | Un UUID v4 nuevo por solicitud | Recomendado | Identifica la solicitud. Se devuelve en el encabezado de la respuesta; si no lo envías, la API genera uno. Guardalo: nos sirve para rastrear una solicitud si necesitas soporte. |
Usá siempre HTTPS. La clave de API viaja en un encabezado, y por HTTP podría ser leída por terceros.
Errores de autenticación
| Caso | Respuesta 401 Unauthorized |
|---|---|
| No se envió apikey | {"message": "Missing API key found in request"} |
| La apikey no es válida | {"message": "Invalid API key in request"} |