Límites de solicitudes

Los límites se aplican por workspace y por X-Client-Name:

límites

Sustained60 solicitudes por minuto

Bursthasta 20 solicitudes en un segundo

Over the limit429 Too Many Requests con un encabezado Retry-After

Buenas prácticas

• Reintenta con retroceso exponencial. Ante un 429, espera los segundos indicados en Retry-After. Ante un 5xx, reintenta las solicitudes idempotentes (GET, PUT, DELETE) con retroceso exponencial y jitter.
• Agrupa las escrituras. POST .../scheduled-visits acepta una ruta completa en una sola llamada: una solicitud para 50 visitas, no 50 solicitudes.
• Pagina con el tamaño máximo (size=200) al leer colecciones completas.
• Guarda en caché lo que cambia poco, como cadenas, marcas y campos de encuesta.
• Sincroniza de forma incremental con since en lugar de volver a leer todo.

Métodos HTTP

Métodos HTTP

GETLeer

POSTCrear

PUTReemplazar (v1)

PATCHActualizar solo los campos que envías (v3)

DELETEEliminar. Nunca lleva cuerpo; los ID van en la ruta o en la cadena de consulta.