Estándar
600 solicitudes/min por key, ráfaga 100. Los webhooks no cuentan.
Límites y errores
Cuotas generosas, cabeceras claras, errores predecibles.
Límites
Cabeceras
Cada respuesta incluye X-RateLimit-Limit, -Remaining y -Reset.
Cuotas mayores
¿Necesita más? Los planes Enterprise amplían el límite.
Códigos de error
400
invalid_paramParámetro malformado401
unauthorizedKey ausente o inválida403
forbiddenSin permiso404
not_foundRecurso inexistente409
conflictTransición ilegal422
validation_failedValidación fallida429
rate_limitedDemasiadas solicitudes500
internal_errorError interno422 Unprocessable Entity
{
"error": "validation_failed",
"message": "qty must be positive",
"details": [{ "field": "lines[0].qty", "issue": "must be > 0" }]
}Versiones
Todo vive bajo /v1. Los cambios disruptivos llegan como /v2 con al menos 12 meses de solape. Los cambios aditivos nunca rompen nada.