Skip to main content

Problemas de API

Errores de Formato​

Payload Inválido​

Síntomas:

  • Error 400 (Bad Request)
  • Mensaje: "Invalid request body"

Solución:

  1. Verifica el formato JSON de tu solicitud
  2. Asegúrate de que todos los campos requeridos están presentes
  3. Comprueba los tipos de datos de cada campo

Parámetros Incorrectos​

Síntomas:

  • Error 400 (Bad Request)
  • Mensaje: "Invalid parameters"

Solución:

  1. Revisa la documentación de la API
  2. Verifica los valores de los parámetros
  3. Asegúrate de que los parámetros están en el formato correcto

Problemas de Webhooks​

Webhook No Recibido​

Síntomas:

  • No se reciben notificaciones
  • Los eventos no se procesan

Solución:

  1. Verifica que la URL del webhook es accesible
  2. Comprueba que el endpoint está respondiendo con 200 OK
  3. Revisa los logs del servidor

Webhook Fallido​

Síntomas:

  • Error 500 en el webhook
  • Reintentos fallidos

Solución:

  1. Implementa manejo de errores en tu endpoint
  2. Asegúrate de que el servidor puede manejar la carga
  3. Verifica la autenticación del webhook

Problemas de Rendimiento​

Latencia Alta​

Síntomas:

  • Tiempos de respuesta lentos
  • Operaciones que tardan más de lo esperado

Solución:

  1. Implementa caché donde sea posible
  2. Optimiza las consultas
  3. Considera usar endpoints más específicos

Errores de Timeout​

Síntomas:

  • Error 504 (Gateway Timeout)
  • Operaciones que exceden el límite de tiempo

Solución:

  1. Reduce el tamaño de las solicitudes
  2. Implementa paginación
  3. Optimiza las consultas para reducir el tiempo de procesamiento

Última actualización: Marzo 2024