¿Qué errores puede devolver la API?

Los errores siguen un formato consistente: un JSON con success: false, un message legible y un código de error, junto al código de estado HTTP. Los más comunes:

• 400 — datos inválidos en la solicitud (revisa el message: indica el campo).
• 401 — token inválido o expirado.
• 403 — permisos insuficientes para el recurso (scopes).
• 404 — el recurso no existe o no es tuyo.
• 429 — límite de tasa excedido (espera y reintenta).
• 500 — error interno del servidor.

Tip: registra el message y el código de error en tus logs; están pensados para diagnosticar sin adivinar. Ante un 429, aplica reintentos con espera creciente (backoff).