Autenticación
Autentica tus peticiones con una API key en el header X-API-KEY y haz tu primer llamado.
La API pública de Mendel se autentica con una API key que envías en el
header X-API-KEY de cada petición.
1. Obtén tu API key
Pide tu API key a tu contacto de Mendel (el aprovisionamiento self-service llega en una próxima versión). Vas a recibir una key por entorno, y cada key es específica del cluster para el que fue emitida. Los hosts de cada cluster y entorno están en Clusters y entornos.
Cuida tu key
La API key identifica a tu empresa y da acceso a datos sensibles. No la publiques en repos ni en el frontend. Rótala si sospechas que se filtró.
2. Haz tu primer llamado
Trae el listado de transacciones de tu empresa. Envía tu key en X-API-KEY:
curl -X GET 'https://mx.stage.app.mendel.com/api/public/v1/purchases' \
-H 'X-API-KEY: tu_api_key_aqui' \
-H 'Accept: application/json'3. Interpreta la respuesta
Un 200 OK devuelve una página de transacciones. Si ves:
401 Unauthorized— falta la key o es inválida. Revisa el headerX-API-KEY. Se responde sin cuerpo.403 Forbidden— la key es válida pero no tiene permiso sobre ese recurso.400 Bad Request— la petición llegó pero algún dato no pasó las validaciones. El cuerpo del error indica el campo.
Cuando tu primer GET funcione, sigue con la Referencia de API para el detalle
de cada endpoint.