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
0 comentarios
Inicie sesión para dejar un comentario.