Ir directamente al contenido
Español
Acceder a la plataforma
  • No hay sugerencias porque el campo de búsqueda está vacío.

Guía de errores de API: Cómo identificar y resolver (400 vs 500)

Al integrarse con las APIs de Logcomex (LogManager, NCM Intel, Shipment Intel, etc.), la respuesta más importante para su diagnóstico es el Código de Estado HTTP (HTTP Status Code).

Antes de abrir un ticket, verifique el código recibido para entender si la acción necesaria está de su lado (cliente) o del nuestro (servidor).

1. Errores del cliente (4xx) - Acción necesaria: corrección en su código

Estos errores indican que la solicitud enviada tiene algún problema de formato, autenticación o datos. El servidor rechazó el pedido.

  • 400 Bad Request (sintaxis inválida)

    • Qué significa: El JSON enviado está mal formateado (coma sobrante, faltan comillas) o envió un tipo de dato incorrecto (ej: envió texto en un campo que exige número).

    • Cómo resolver: Valide su JSON en un Linter. Verifique en la documentación si los campos obligatorios fueron completados y si los tipos de datos (String, Integer, Boolean) son correctos.

  • 401 Unauthorized (falla de autenticación)

    • Qué significa: El sistema no reconoció quién es usted. Generalmente problemas con la API Key o Token.

    • Cómo resolver:

      • Verifique si el header x-api-key o Authorization está escrito correctamente.

      • Revise si no hay espacios en blanco antes o después de la clave.

      • Confirme si su clave aún está activa con su Gerente de Cuentas.

  • 404 Not Found (no encontrado)

    • Qué significa: El Endpoint (URL) es incorrecto o el ID del recurso que intentó buscar no existe.

    • Cómo resolver: Verifique la grafía de la URL en la documentación oficial. Si es una búsqueda por ID (ej: buscar un contenedor específico), confirme si ese ID realmente existe en la base.

  • 429 Too Many Requests (bloqueo por volumen)

    • Qué significa: Superó el límite de solicitudes por mes de su plan.

    • Cómo resolver: Implemente una lógica de backoff (espera) en su código. Espere unos segundos antes de intentar nuevamente.

 

2. Errores del servidor (5xx) - Acción necesaria: esperar o reportar

Estos errores indican que su solicitud llegó correctamente, pero el servidor de Logcomex (o una fuente externa) falló al procesarla.

  • 500 Internal Server Error / 502 Bad Gateway

    • Qué significa: Falla interna o inestabilidad momentánea.

    • Escenario común en Logística: Muchas de nuestras APIs consultan fuentes gubernamentales en tiempo real (Portal Único, Mercante, Sefaz). Si estos portales están inestables o fuera de línea, nuestra API devolverá un error 5xx.

    • Cómo resolver:

      1. Espere de 5 a 10 minutos e intente nuevamente (Retry).

      2. Si el error persiste por más de 1 hora, abra un ticket de soporte.

  • 504 Gateway Timeout

    • Qué significa: La fuente de datos tardó demasiado en responder y la conexión expiró.

    • Cómo resolver: Espere e intente nuevamente más tarde.

 

3. ¿Cómo reportar un error a Soporte?

Si identificó un error persistente o bug, envíe la información a continuación para agilizar el análisis técnico (sin estos datos, el tiempo de resolución aumenta):

  1. Endpoint completo: (Ej: POST https://api-prd-logmanager.logcomex.io/api/v1/search)

  2. El Payload (Body) enviado: (El JSON exacto que envió).

  3. La Respuesta de Error completa: (El código y el mensaje JSON que la API devolvió).

  4. Horario del intento: Fecha y hora exacta.