Límites y errores

Lea todas las páginas, respete los límites de velocidad y recupérese de los errores de forma segura.

1. Límites de velocidad

   Los límites son configurables. GET y /v1/operations/capabilities informan de requestsPerMinute y authenticationRequestsPerMinutePerIp. Tras un error 429, respete la opción "Retry-After" y espere más tiempo si la limitación de velocidad continúa. Las lecturas por lotes aceptan hasta 100 ID; los puntos finales individuales pueden tener límites de página o de carga útil menores.

2. Lee cada página

   Utilice la regla de continuación para el punto final que llamó, manteniendo los mismos filtros. Las listas pueden cambiar mientras las lee; utilice instantáneas cuando necesite una copia consistente.

   Paginación	Continuar con	Detenerse cuando
   Cursor	Pasar next como after.	El siguiente es null.
   Desplazamiento con nextOffset	Pasar nextOffset como offset.	nextOffset es null.
   Desplazamiento con hasMore	Incrementar el desplazamiento según el número de elementos devueltos.	hasMore es falso.
   Software	Pasar el valor numérico next como after; reiniciar si updatedAtUtc cambia.	El siguiente es null.
   Fuente de eventos	Pasar next como after.	hasMore es falso.

3. Gestionar errores

   Leer el código de error y el estado HTTP. Si la respuesta incluye requestId, indíquelo al contactar con soporte.

   Estado HTTP	Qué hacer
   400	Corrija la solicitud.
   401	Verifique las credenciales u obtenga un nuevo token de acceso.
   403	Verifique el alcance, los permisos y si el acceso está habilitado.
   404	Es posible que falte el recurso o que esté fuera de su ámbito.
   409	Lea el código de error y el estado actual antes de decidir.
   410	El cursor de instantánea o evento ha caducado. Inicie una nueva línea base.

4. Si se agota el tiempo de espera de una escritura:

   Un tiempo de espera agotado o un error 503 no prueba que la acción haya fallado. Para las escrituras que devuelven recibos de operación, consulte GET /v1/operations/by-key?idempotencyKey={key} antes de volver a intentarlo. Para la creación de mantenimiento, reutilice el Idempotency-Key original y el cuerpo.