Datos del comprador
Tarjetas, direcciones de envío, datos de facturación, destinatarios y favoritos que el cliente guarda en su cuenta.
Qué incluye
Rutas para que el cliente guarde y administre sus propios datos:
Reglas comunes
- Todas exigen el token del cliente en la cabecera
Authorization: Bearer <token>. Ver autenticación. - Cada cliente solo ve y modifica sus propios registros. Un identificador que existe pero es de otro cliente responde igual que uno inexistente: 404.
- Los campos de texto se envían como cadena, aunque contengan solo cifras. Un número JSON en un campo de texto responde 422.
- Borrar una tarjeta, una dirección, un dato de facturación o un destinatario no lo elimina de la base de datos: deja de aparecer, pero se conserva.
- Los listados devuelven todos los registros del cliente, sin paginar.
Errores comunes
Además de los propios de cada ruta, cualquiera de estas puede responder:
| HTTP | code | Cuándo |
|---|---|---|
| 401 | SESSION_EXPIRED |
No se envió el token |
| 401 | TOKEN_INVALID |
El token no es válido |
| 403 | NOT_A_STORE_USER |
El token no es de un cliente de la tienda |
| 422 | VALIDATION_ERROR |
Algún dato no cumple las reglas. El detalle por campo va en errors |
| 429 | RATE_LIMITED |
Se superó el límite de peticiones. Espera lo que indica la cabecera Retry-After |
| 500 | INTERNAL_ERROR |
Fallo del servidor. Guarda el valor de reference para reportarlo |