Errores
La API REST utiliza códigos de estado HTTP estándar y devuelve un cuerpo de error JSON:
{ "error": "unauthorized", "message": "Missing or invalid API key" }
# Códigos de estado
| Estado | error |
Cuándo |
|---|---|---|
400 |
invalid-argument |
Cuerpo mal formado o campo requerido faltante. |
401 |
unauthorized |
Clave API faltante, inválida o revocada. |
403 |
forbidden / failed-precondition |
Más allá del derecho de su plan (p. ej. acuñación de códigos serializados sin Enterprise, o superando una cuota). El límite está en el mensaje. |
404 |
not-found |
Sin enlace/campaña/trabajo con ese id, o no es propiedad de su cuenta. |
429 |
rate-limited |
Se excedió el límite de velocidad por clave — retroceda e intente de nuevo. |
5xx |
internal |
Algo salió mal de nuestro lado; es seguro reintentar lecturas idempotentes. |
# Propiedad
Cada lectura y escritura está limitada a la cuenta en la que se resuelve la clave API. Solicitar un enlace o campaña de otra cuenta devuelve 404 (no 403) — no revelamos que exista.
# Trabajos asincronos
Los trabajos de lote y acuñación serializada aceptan la solicitud
(200, queued), luego muestran fallas en el estado del trabajo (status: "failed" con un motivo), no en la respuesta HTTP original. Siempre consulte el trabajo.
# Verificación
Los puntos finales públicos de verificación nunca dan error en un número de serie desconocido —
devuelven status: "unknown" (un código falso/no emitido es una respuesta significativa, no un 404).
# Siguiente
- Autenticación · la referencia de API completa.