Idempotencia y paginación

Idempotencia

OpenAPI declara si cada operación admite Idempotency-Key y si la exige. Reutiliza la clave solo para la misma solicitud lógica. Una carga distinta con la misma clave genera conflicto; una operación en curso puede responder con conflicto en lugar de duplicar trabajo.

POST /v1/environments/{environmentId}/invoices
Authorization: Bearer <environment-api-key>
Idempotency-Key: <stable-operation-key>
Content-Type: application/json

No reintentes a ciegas

La idempotencia no hace seguro repetir un envío externo ambiguo, salvo que ese endpoint lo garantice. No reintentes automáticamente emisión ni mutaciones de envío con resultado incierto.

Paginación por cursor

Algunos listados usan límite y cursor de continuación. Pasa el cursor devuelto como siguiente valor after sin modificarlo. Conserva el mismo tenant y filtros durante el recorrido y termina cuando no se devuelva cursor.

• Scopes, parámetros e idempotencia por operación