· SDKv0.4.0Headers y límites
Idempotencia
Idempotency-Key admite entre 1 y 128 caracteres en las operaciones de generación.
- misma clave y mismo payload: replay seguro;
- misma clave y otro payload:
409 idempotency_key_reused; - operación equivalente aún en curso:
409 idempotency_request_in_progress.
Idempotency-Replayed: true|false indica si se devolvió un resultado persistido.
Rate limit y consumo
| Header | Significado |
|---|---|
RateLimit-Limit | Solicitudes disponibles en la ventana |
RateLimit-Remaining | Solicitudes restantes |
RateLimit-Reset | Momento de reinicio |
X-Inceptiva-Usage-Limit | Cuota de uso configurada |
X-Inceptiva-Usage-Remaining | Cuota restante |
Retry-After | Espera recomendada tras un 429 |
Los SDK conservan estos valores en responseMetadata, response_metadata o ResponseMetadata, y también dentro de los errores tipados.