API para Developers

Integra la logística de Kold Gold en tu sistema

Una API REST para crear embarques, consultar rastreo en vivo, cotizar y recibir eventos por webhook. Autenticación por API key, respuestas en JSON.

Base URL

https://api.kold.gold

Autenticación

Envía tu API key en el header. Genera llaves en el Centro de Mando → Developers.

Authorization: Bearer kg_live_xxxxxxxx

Endpoints principales

GET	/v1/embarques	Lista tus embarques con estado y fechas.
GET	/v1/embarques/{id}	Detalle de un embarque, incluyendo documentos.
POST	/v1/embarques	Crea un embarque desde tu sistema.
GET	/v1/tracking/{codigo}	Rastreo público por código de embarque (B/L o AWB).
POST	/v1/cotizaciones	Solicita una cotización programática.
POST	/v1/webhooks	Registra un endpoint para recibir eventos de estado.

Ejemplo — rastrear un embarque

curl https://api.kold.gold/v1/tracking/KG-BL-2026-004 \
  -H "Authorization: Bearer kg_live_xxxxxxxx"

# 200 OK
{
  "identificador_rastreo": "KG-BL-2026-004",
  "estatus_logistico": "en_transito",
  "origen": "Shanghai",
  "destino": "Manzanillo",
  "posicion_actual": "En tránsito marítimo",
  "actualizado": "2026-07-09T02:29:35Z"
}

Webhooks en tiempo real

Registra un endpoint y recibe un POST cada vez que un embarque cambia de estado, se libera en aduana o se carga un documento. Ideal para sincronizar tu ERP sin polling.

Solicitar acceso a la API