flexport-hello-world

# Flexport Hello World ## Overview List shipments and retrieve tracking milestones using the Flexport REST API v2. Flexport has no npm SDK -- you call `https://api.flexport.com` directly with bearer token auth and a `Flexport-Version: 2` header. ## Prerequisites - `FLEXPORT_API_KEY` environment variable set - Completed `flexport-install-auth` setup - Node.js 18+ (uses native `fetch`) ## Instructions ### Step 1: List Your Shipments ```typescript // src/flexport/hello.ts const BASE = 'https://api.flexport.com'; const headers = { 'Authorization': `Bearer ${process.env.FLEXPORT_API_KEY}`, 'Flexport-Version': '2', 'Content-Type': 'application/json', }; // List shipments with pagination const res = await fetch(`${BASE}/shipments?per=5&page=1`, { headers }); const { data } = await res.json(); data.records.forEach((shipment: any) => { console.log(`${shipment.id} | ${shipment.status} | ${shipment.freight_type}`); console.log(` Origin: ${shipment.origin_port?.name ?? 'N/A'}`); console.log(` Dest: ${shipment.destination_port?.name ?? 'N/A'}`); }); ``` ### Step 2: Get Shipment Details with Milestones ```typescript // Retrieve a single shipment with tracking milestones const shipmentId = data.records[0].id; const detail = await fetch(`${BASE}/shipments/${shipmentId}`, { headers }).then(r => r.json()); console.log(`\nShipment ${detail.data.id}:`); console.log(` Status: ${detail.data.status}`); console.log(` Cargo ready: ${detail.data.cargo_ready_date}`); conso...