Manejo de errores
Revisa el estado HTTP junto con el cuerpo de la respuesta. Los campos de error varían por endpoint; consulta el contrato exacto en la referencia de la API.
- Ante un timeout o un error 5xx temporal, consulta primero cualquier ID de contenido o trabajo recibido. Para reintentar la misma operación, conserva el mismo contenido e idempotency_key y limita los reintentos con espera progresiva. HTTP 202 indica aceptación, no publicación exitosa.
- Ante 409 idempotency_conflict, compara la solicitud original y su resultado. No generes otra clave automáticamente. Usa una nueva solo para una operación nueva e intencional, después de comprobar la anterior.
- Corrige la entrada o los problemas de autenticación y permisos antes de reintentar. Ante 429, revisa el error y Retry-After si existe: una cuota agotada puede requerir su restablecimiento o un cambio de plan, no una espera breve.
{ "error": "insufficient_scope", "message": "publishing:write scope is required for this API request."}