Obtén una clave de API para tu integración

Cómo obtener una clave de API si tu sistema no es uno de los TMS con los que Cargado se integra, qué significan los permisos y cómo proteger la clave.

Both

Updated

October 2, 2026

En 3 pasos

Pide una clave a tu contacto en Cargado
Envía la clave en el encabezado api-key
Guarda la clave en un gestor de secretos

Si tu sistema no es uno de los TMS con los que Cargado se integra (consulta Conecta tu TMS), de todas formas puedes conectarte a Cargado por la API. El equipo de Cargado crea la clave por ti.

Paso 1: Pide una clave a tu contacto en Cargado

Pide una clave de API a tu contacto en Cargado. Dile el nombre de la integración y lo que necesita hacer. Las opciones son sincronizar embarques, administrar relaciones con transportistas, administrar equipos, administrar usuarios y consultar tarifas de mercado. La clave se crea solo con esos permisos. Una misma clave puede tener varios.

Importante: La clave completa se muestra una sola vez, cuando se crea, así que ten listo tu gestor de secretos.

Paso 2: Envía la clave en el encabezado api-key

Las claves empiezan con cgk_. No uses el resto del prefijo para distinguir una clave de producción de una de pruebas: etiqueta cada clave tú mismo en tu gestor de secretos. Envía la clave en un encabezado api-key en cada solicitud, o como token Bearer en un encabezado Authorization. Los nombres de los encabezados no distinguen mayúsculas, así que Api-Key también funciona.

Arriba: un editor de código, oscurecido, con las tres líneas de encabezado de la solicitud resaltadas y marcadas como Paso 2. Abajo, de cerca: POST https://api.cargado.com/rates/history, api-key: cgk_ seguido de una clave oculta, y Content-Type: application/json. La marca 1 señala la línea POST. La marca 2 señala el encabezado api-key.

Ejemplo: la clave es ficticia y está oculta.

POST https://api.cargado.com/rates/history: la solicitud.
api-key: tu clave, en cada solicitud. Aquí aparece oculta.

Paso 3: Guarda la clave en un gestor de secretos

Guarda la clave en el gestor de secretos de tu plataforma. No en una hoja de cálculo, un mensaje de chat ni un correo. Si crees que una clave se filtró, avisa de inmediato al equipo de Cargado. Una clave se puede rotar: la rotación genera una clave nueva y deja la anterior funcionando siete días, para que cambies sin interrupciones. Una clave también se puede revocar por completo.

Consejo: El add-in de Excel no necesita clave. Cada persona inicia sesión con su propio acceso de Cargado. Consulta Instala y usa el add-in de Excel.

Para tomar en cuenta

Una clave, dos usos: una sola clave puede cubrir la API de Tarifas de Mercado y el resto de la API. Lo que puede hacer depende de los permisos que pidas.
API de Tarifas de Mercado: pide "consultar tarifas de mercado". Tu sistema envía una ruta y recibe Bajo, Medio y Alto, el mismo rango que ves en la plataforma, con una etiqueta de confianza y un margen de error cuando Cargado los tiene. Consulta Consulta tarifas de mercado con la API.
Exportación semanal: un plan Enterprise con la exportación activada también puede descargar un archivo semanal de tarifas de mercado. Consulta Descarga la exportación semanal de tarifas de mercado.
El resto de la API: sincronizar embarques desde tu sistema y administrar relaciones con transportistas, equipos y usuarios.
Tu plan: para las empresas de logística, las consultas de tarifas de mercado hechas con una clave cuentan para el uso medido del plan igual que las consultas en la plataforma, sujetas a deduplicación: las consultas repetidas de la misma ruta cuentan una vez por versión de los datos, mercados, categoría de remolque y cruce, y una versión nueva de los datos vuelve a contar. Las consultas de las cuentas de transportista no se miden. Consulta Límites del plan y qué significan los correos de aviso de uso.
Montos: las tarifas regresan en la unidad menor de la moneda: centavos de dólar para USD y CAD, centavos de peso para MXN. En USD, 330000 es $3,300.
Referencia: los endpoints están documentados en docs.cargado.com.