Clusters y entornos
Misma estructura de rutas en todos los clusters; lo único que cambia es el host.
Mendel opera en varios clusters (por país y por cliente whitelabel). Todos comparten la misma estructura de rutas de la API pública; lo único que cambia entre un cluster y otro —y entre entornos— es el host.
Misma ruta, distinto host
Todos los recursos viven bajo /api/public/v1/…. Para apuntar a tu cluster y
entorno, solo cambias el host de la base URL:
curl -X GET 'https://{HOST}/api/public/v1/purchases' \
-H 'X-API-KEY: tu_api_key_aqui'El bloque de arriba ya usa el host de la selección actual. Tu contacto de Mendel te confirma cuál es tu cluster durante el onboarding, junto con tu API key.
Ejemplos del portal
Elige tu cluster y entorno en el panel lateral: los ejemplos de código de todo el portal se reescriben al host correcto. Por defecto usan el Stage de México.
Clusters y hosts
| Cluster | País | Tipo | Stage | Producción |
|---|---|---|---|---|
| México | México | Regional | mx.stage.app.mendel.com | mx.app.mendel.com |
| Argentina | Argentina | Regional | ar.stage.app.mendel.com | ar.app.mendel.com |
| BICE | Chile | Whitelabel | bice.stage.app.mendel.com | bice.app.mendel.com |
| CMF | Argentina | Regional | ar.stage.app.mendel.com | cmf.mendel.com |
Tu API key es específica de un cluster: opera sobre la compañía y el cluster para los que fue emitida.
Entornos
Los clusters exponen hasta dos entornos, con keys y hosts distintos:
| Entorno | Uso |
|---|---|
| Stage | Pruebas e integración. No afecta datos productivos. |
| Producción | Datos reales de tu empresa. |
Mira siempre la tabla de arriba para el host exacto: algunos clusters comparten host de Stage (CMF usa el de Argentina), y tu API key es la que determina sobre qué compañía y cluster operas.
No mezcles keys entre entornos
Las keys de Stage y de producción no son intercambiables. Usa siempre la key del entorno correcto y nunca expongas la key de producción en clientes web o móviles.
Diferencias por país
La estructura de rutas es común, pero algunos recursos y campos varían según el país de tu cluster. Por ejemplo, la información fiscal de una transacción difiere entre México (CFDI) y Argentina (IVA / IIBB), y ciertos catálogos pueden estar disponibles solo en algunos clusters.
Cuando un campo o recurso depende del país, lo aclaramos en la Referencia.