Paper API personal
Errores
Los códigos de respuesta y qué hacer con cada uno.
Todo error vuelve en JSON, con un mensaje que se puede mostrar a la persona. El mensaje viene en el idioma del encabezado Accept-Language (pt-BR, en o es; portugués si falta):
{ "error": "Este token solo puede leer esta bóveda." }| Código | Cuándo ocurre | Qué hacer |
|---|---|---|
400 | Falta un campo o el formato es incorrecto | Corrige la solicitud. El mensaje dice qué. |
401 | Token ausente, mal formado, inválido, revocado o vencido | Pídele un token nuevo a la persona. No reintentes con el mismo. |
403 | Sin permiso para la bóveda, la agenda o los adjuntos; cuenta distinta de la indicada en X-Paper-Account; modo desarrollador desactivado; cuenta baneada | No insistas. Avisa a la persona de lo que falta. |
404 | Bóveda o página no encontradas | Revisa los ids con GET /vaults y GET /vaults/{boveda}/pages. Las bóvedas deben estar sincronizadas con Google Drive. |
409 | Google o la agenda no se habilitaron para la API, o la persona revocó el acceso en Google | La persona debe abrir la app y habilitarlo de nuevo en Configuración → Desarrollador. |
413 | Archivo o texto demasiado grande | Divídelo o redúcelo. Mira Límites. |
423 | Página protegida con contraseña | Deja la página en paz. Ningún token la abre. |
429 | Límite de solicitudes o de envíos | Espera y vuelve a intentar, con intervalos crecientes. |
500 | Un error de nuestro lado | Vuelve a intentar en unos minutos. Si se repite, avisa a soporte. |
502 | Google Drive o Google Calendar fallaron | Vuelve a intentar más tarde. |
503 | Servicio en mantenimiento | Vuelve a intentar más tarde. |
Reintentar
Solo vale la pena reintentar en 429, 500, 502 y 503. Usa intervalos crecientes y un tope de intentos. Los demás códigos no cambian solos.