Home / Technical Reference / Transportation API Architecture
Transportation Developer Guide & Integration Patterns
Transportation API & Integration Architecture Library
An engineering reference for freight software engineers, logistics IT directors, and integration teams. Explore standard REST request/response schemas, event-driven webhook patterns, ELD telematics ingestion, and hybrid EDI-to-REST pipelines.
1. Modern Freight Integration Architecture: EDI & REST Coexistence
Enterprise logistics requires supporting both asynchronous batch B2B protocols (ANSI ASC X12 EDI) and low-latency, event-driven HTTP REST APIs. Rather than forcing shippers or motor carriers into a single standard, modern Transportation Management Systems deploy an API translation gateway that normalizes incoming loads regardless of origin.
Unified Shipment State Machine
Whether a shipment arrives via EDI 204 from a retail distribution network or via JSON REST API from a 3PL customer portal, the payload is parsed into an immutable domain entity.
2. Standard Freight Load Tender Ingestion (POST /api/v1/shipments/tender)
Allows shippers, 3PL brokers, and ERP systems (SAP, Oracle, NetSuite) to programmatically tender loads directly to EXSPEEDITE TMS and the Pipeline freight customer portal. Mirrors the informational payload of an ANSI X12 204 transaction with clean JSON semantics.
| Field | Type | Requirement | Description |
|---|---|---|---|
tender_id |
String | Required | Unique shipper-assigned tender identification code (B204). |
action |
String | Required | TENDER_NEW, TENDER_UPDATE, or TENDER_CANCEL. |
stops |
Array<Stop> | Required | Ordered collection of origin, intermediate, and destination facilities. |
rate |
Object | Optional | Agreed linehaul, FSC calculation method, and accessorial commitments. |
3. Event-Driven Webhooks: Real-Time Shipment Status Updates
Instead of continuous polling, shippers and partner brokers subscribe to webhook endpoints. Whenever a driver triggers a milestone in the TMS (via ELD, CheckPoint GPS, or driver app), an HTTP POST is emitted with an HMAC SHA-256 signature.
4. Webhook Reliability: Exponential Backoff with Jitter
In freight transportation, network outages and receiving server downtime must not cause lost milestones. Exspeedite implements idempotent message delivery with exponential backoff and jitter algorithms across 5 retry attempts over a 24-hour cycle.
5. Frequently Asked Questions: Transportation APIs & Integrations
Common architectural questions encountered by logistics engineers and enterprise carriers implementing Exspeedite REST and EDI services.
How does EXSPEEDITE bridge ANSI X12 EDI 204 tenders with REST APIs?
EXSPEEDITE normalizes incoming shipment tenders from EDI 204 batches and JSON REST endpoints into an immutable domain entity. Shippers can post orders via REST or legacy EDI without requiring custom point-to-point translation software.
How are webhook delivery failures handled in the transportation API?
EXSPEEDITE utilizes exponential backoff with decorrelated jitter across 5 retry attempts over a 24-hour cycle. Webhook payloads include an HMAC SHA-256 signature in the X-Exspeedite-Signature header to ensure cryptographic authenticity and prevent replay attacks.
Can enterprise shippers query shipment tracking status via REST endpoints?
Yes. Enterprise shippers and partner brokers can query /api/v1/shipments/{id}/status or subscribe to event-driven webhooks for instant geofenced arrival, departure, and in-transit milestone alerts with latitude, longitude, speed, and driver HOS duty hours.
Does the API support ELD telematics ingestion from mixed fleet providers?
Yes. The EXSPEEDITE telematics pipeline ingests real-time GPS coordinates and HOS duty clocks from Samsara, Motive, Geotab, and PeopleNet, as well as app-less driver location pings from CheckPoint.
Related Technical Infrastructure
Carrier Fleet Intelligence →
Real-world intelligence index of 6,260+ verified commercial motor carriers with SAFER operational footprints.
ANSI X12 EDI Dictionary →
Examine segment definitions for EDI 204, 214, 210, 990 and 997 transaction sets.
Freight Tech Intelligence Center →
Analysis on Samsara telematics, Sage Intacct accounting sync, and FMCSA fraud prevention.
Freight Labor Calculators →
Interactive economic calculators for manual dispatch cost and billing cycle compression.
Multi-Company Enterprise Platform →
Enterprise tenant isolation, multi-MC fleet governance, and centralized API gateways.