Límites y mantenimiento
Límite de peticiones
Sección titulada «Límite de peticiones»Cada dirección IP puede hacer como máximo 600 peticiones cada 5 minutos (300 en el entorno de pruebas). Al superarlo, la respuesta es 429:
{ "error": true, "message": "Demasiadas peticiones. Vuelve a intentarlo más tarde." }Las respuestas incluyen los encabezados RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset, y la respuesta 429 además Retry-After con los segundos que hay que esperar.
Si desde una dirección IP llegan 20 respuestas 401 en 15 minutos (por una clave no válida o por falta de permiso), todas sus peticiones responden 429 hasta que pasen esos 15 minutos, aunque después use una clave correcta:
{ "error": true, "message": "Demasiados intentos con una API key no válida. Vuelve a intentarlo dentro de 15 minutos." }Mantenimiento
Sección titulada «Mantenimiento»Durante una parada por mantenimiento, todas las peticiones responden con el código de estado HTTP 503 y este cuerpo:
{ "message": "Tukonta está en mantenimiento. Vuelve a intentarlo en unos minutos." }La respuesta incluye el encabezado Retry-After con los segundos que conviene esperar antes de reintentar. Las peticiones que reciben 503 no se procesan: hay que repetirlas cuando termine el mantenimiento.