¿Cuáles son los límites y mensajes de error de la API?

¿Cuántas solicitudes puedes hacer?

La API limita el número de solicitudes por minuto y por cuenta.

Si superas este límite, recibirás un 429 con una cabecera que te indica cuánto tiempo debes esperar:

HTTP/1.1 429 Too Many Requests
Retry-After: 60

{
  "error": {
    "type": "invalid_request",
    "message": "Rate limit exceeded, try again after 60 seconds"
  }
}

No hay cabeceras que lleven el registro de tu consumo mientras todo vaya bien. Por lo tanto, espera al Retry-After y lleva tú mismo el control de cuántas solicitudes envías. Además, guarda en caché lo que rara vez cambia: no necesitas recuperar los campos de una lista en cada visualización de página, con una vez al día es suficiente.

¿Cómo es un mensaje de error?

Todos los mensajes de error tienen la misma estructura, por lo que puedes gestionarlos en un único lugar. Cada error se devuelve como JSON con un type, un message y, por lo general, un code y el parameter que causó el error.

{
  "error": {
    "type": "invalid_input",
    "message": "Email: invalid address",
    "code": 208,
    "parameter": "email"
  }
}

El campo type puede tener tres valores: invalid_request si la propia llamada no es correcta, invalid_input si los datos enviados no son correctos e internal si algo falla por parte de Laposta.

Códigos de estado

La API utiliza códigos de estado HTTP estándar para indicar cómo ha ido la solicitud.

Códigos de error

Con invalid_input se incluye un código numérico para que puedas traducir el error a un mensaje para tu propio usuario. Junto con parameter, sabrás exactamente de qué campo se trata.

Un id de otra cuenta devuelve el mismo mensaje que un id que no existe en ninguna parte: Unknown list, con el código 203. Esto es intencionado, para que no se pueda ver qué hay en otras cuentas.

Artículos relacionados