Tengo un cliente creado para la API oceánica de ShipsGo v2. ¿Puede funcionar en Dockflow con las mismas rutas y cuerpos?
Sí. Cambia dos valores:
- Establece la URL base en https://api.dockflow.com/compat/shipsgo/v2
- Coloca una clave de API de Dockflow en X-Shipsgo-User-Token. Crea la clave en la consola de API con el ámbito Downstream.
Un caso práctico, con un token ficticio. Crea un envío:
POST /compat/shipsgo/v2/ocean/shipments
X-Shipsgo-User-Token: prod_acme_FAKE-TOKEN
{"reference":"PO-5521","booking_number":"BK-7741"}
La respuesta contiene el id del envío. Consúltalo de nuevo con ese id. Esta respuesta está abreviada:
GET /compat/shipsgo/v2/ocean/shipments/74123
{"message":"SUCCESS","shipment":{"id":74123,
"reference":"PO-5521","booking_number":"BK-7741",
"status":"BOOKED"}}
Hay tres diferencias. Los filtros de lista distintos del id y el número de contenedor se rechazan, los seguidores y las etiquetas permanecen vacíos, y las rutas aéreas no están cubiertas. La lista se ordena por última modificación, de más antiguo a más reciente, y se rechaza cualquier order_by. Hasta que se haya ejecutado la importación, una lectura muestra solo el número que enviaste. Los destinos de webhook los añade el soporte de Dockflow, y cada entrega lleva X-Shipsgo-Webhook-Signature.
Asignación completa de campos y verificación de la firma: