Introducción
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.