Mi cliente utiliza el intercambio de tokens y las rutas de seguimiento de project44 v4. ¿Qué hay que cambiar?
Dos valores:
- Establece la URL base en https://api.dockflow.com/compat/project44
- Usa una clave de API de Dockflow como secreto de cliente. Crea la clave en la consola de API con el alcance Downstream.
Un caso práctico, con un secreto ficticio. El intercambio devuelve el secreto como token:
POST /compat/project44/api/v4/oauth2/token
grant_type=client_credentials&client_id=my-app&client_secret=prod_acme_FAKE-TOKEN
{"access_token":"prod_acme_FAKE-TOKEN","token_type":"BEARER","expires_in":3600}
Inicia el seguimiento. Esta respuesta está abreviada:
POST /compat/project44/api/v4/shipments/tracking
Authorization: Bearer prod_acme_FAKE-TOKEN
{"identifiers":[{"type":"BILL_OF_LADING","value":"BL-7741"}]}
{"id":"00000000-0000-4000-8000-000000012345",
"identifiers":[{"type":"BILL_OF_LADING","value":"BL-7741"}],
"problems":[]}
Los mismos identificadores siempre llegan al mismo envío. Cada contenedor también obtiene su propio id secundario, que funciona en las rutas de lectura y eliminación. Un tipo de identificador fuera de la lista publicada responde con 400.
Lee por ese id. Las posiciones, los costos y los contenidos permanecen vacíos. Las rutas de webhook responden con 403, así que el soporte de Dockflow añade tu destino. Cada entrega incluye el cuerpo de la lectura del historial y un encabezado X-Dockflow-Signature.
Mapeo completo de campos y la verificación de la firma: