Empezar

Introducción

La API REST de Cozter para crear y rastrear guías de envío.

La API de Cozter te permite integrar la red de logística de Cozter directamente en tu sistema: crear guías, rastrear envíos, obtener la prueba de entrega y recibir notificaciones de estado por webhook.

Todas las rutas viven bajo un único prefijo. Las respuestas son JSON en UTF-8 y usan vocabulario en español.

URL base

https://cozter.com/api/v1

Formato

Las solicitudes con cuerpo usan Content-Type: application/json. Toda respuesta exitosa incluye ok: true:

{
  "ok": true
}

Los errores devuelven un código HTTP apropiado y un mensaje legible. Ver Errores.

Primeros pasos

Obtén tu clave de API

Un administrador de tu comercio emite una clave czk_… desde la configuración. Se muestra una sola vez. Ver Autenticación.

Crea tu primera guía

Envía un POST a /api/v1/guias con el teléfono del destinatario, el destino y las coordenadas de recogida. Ver Crear una guía.

Rastrea el envío

Consulta el estado con GET /api/v1/guias/:guia o deja que Cozter te avise con webhooks.