Límites y convenciones

Rate limits

Por llave API:

Al excederlos: 429 con código RATE_LIMITED y el header Retry-After (segundos hasta la siguiente ventana). Respétalo con retroceso exponencial. ¿Tu operación necesita más? Escríbenos — los límites son ajustables por llave.

Tamaños

Paginación

Todas las listas: ?limit=25&startingAfter=<id> → { "data": [...], "hasMore": true }. El orden es por creación descendente y es estable — pagina con el id del último elemento, no con offsets.

Timeouts recomendados

Configura tu cliente HTTP con timeout de 30 segundos: las operaciones que tocan didi/indrive en vivo (registro, invitación, refresh) son síncronas y pueden tardar varios segundos. El resto responde en milisegundos.

Idempotencia

• Re-registrar un vehículo o re-invitar un conductor responde 200 con el estado actual — repetir es seguro.
• Los duplicados (placa, VIN, WhatsApp) responden 409 — nunca se crean dobles.
• Aceptamos el header Idempotency-Key y lo registramos desde hoy; la deduplicación automática con él llegará en una versión futura sin cambio de contrato.

Encabezados útiles