Docs / Errores

Troubleshooting para producción

Lista de errores comunes, diagnóstico rápido y acciones de remediación para integraciones MCP y webhooks.

Revisar Auth Volver a API
Código Descripción Causa típica Acción recomendada
401_UNAUTHORIZED Credencial inválida o ausente. API key incorrecta o vencida. Rotar clave y verificar headers.
403_STORE_SCOPE Store no autorizada para la clave. Desalineación entre `store_id` y key. Reemitir credenciales con scope correcto.
422_INVALID_INPUT Payload no válido. Campos faltantes o tipos incorrectos. Validar contra ejemplos de API reference.
429_RATE_LIMIT Límite de requests alcanzado. Ráfaga sin backoff. Aplicar retries exponenciales con jitter.
500_UPSTREAM_SYNC Error interno de sincronización. Timeout/latencia de origen. Reintentar, revisar estado y logs de eventos.