¿Qué hacer si la API responde con error?

Si alguno de los servicios de la API de Multivende retorna error al hacer una consulta, lo ideal es seguir un proceso ordenado para identificar la causa y resolverlo.

Puede acontecer durante tu implementación que la api no retorne información o retorne algún error no esperado, por ejemplo al consultar el stock, las ventas o los productos.. A continuación te presentamos una lista de posibles causas que puedes validar:

 1. Lee el código de estado (status code)

El código HTTP te dice mucho sobre el tipo de error:

• 400 → Solicitud mal formulada (Bad Request)
• 401 / 403 → Error de autenticación o permisos
• 404 → Recurso no encontrado
• 405 → Método no permitido (por ejemplo, usaste GET en vez de POST)
• 500 / 502 / 503 / 504 → Error del servidor o servicio caído

2. Revisa el cuerpo del error (response body)

La mayoría de APIs devuelven un mensaje explicativo. Ejemplo:

{
 "error": "Missing parameter 'productId'"
}

Esto te indica directamente qué parámetro falta o está mal.

3. Verifica tu solicitud (request)

Comprueba que:

• La URL del endpoint esté correcta.
• El método HTTP coincida con lo que la API espera (GET, POST, PUT, DELETE).
• Los headers sean los adecuados (Content-Type, Authorization, etc.).
• El body tenga el formato correcto (por ejemplo, JSON válido).

👉 Puedes probar la solicitud en Postman o cURL para ver la respuesta directamente.

4. Revisa autenticación y permisos

Errores comunes:

• Token vencido.
• Token sin permisos para ese endpoint.

💡 Para OAuth2, revisa si el grant type y los scopes son los correctos.

 5. Valida los parámetros

Asegúrate de enviar:

• Todos los parámetros requeridos.
• En el formato correcto (por ejemplo, número vs string).
• Sin valores nulos o vacíos si no están permitidos.

Ejemplo:

{
 "user_id": 123,
 "email": "user@example.com"
}

 6. Consulta la documentación

Busca el endpoint específico en la documentación de la API y revisa:

• Qué campos son obligatorios.
• Qué valores acepta.
• Ejemplos de solicitudes exitosas.

7. Activa logs o consola de depuración

Si estás desarrollando:

• Usa herramientas como console.log() o logs del servidor.
• Captura tanto el request como el response para ver qué se está enviando y recibiendo.

 8. Contacta al soporte de la API

Si todo está correcto y el error persiste, puede ser:

• Un problema temporal del servidor.
• Un bug en la API.

Proporciona al soporte:

• URL del endpoint
• Método HTTP
• Cuerpo de la solicitud
• Respuesta completa (código + mensaje)

Envía esta información con el detalle de tu caso mediante nuestro formulario de soporte API Multivende

Equipo de API Multivende