{"name":"Supply Chain Events API","version":"0.1.0","description":"Real-time supply chain disruption events from weather, ports, vessels, and geopolitical sources","endpoints":{"GET /events":"List active events with optional filters","GET /events/:id":"Get event by ID","GET /alerts":"Severe/extreme events only","GET /summary":"Dashboard summary with counts","GET /stats":"Database statistics","GET /health":"Health check","GET /dashboard":"Interactive web dashboard","GET /webhooks":"List registered webhooks","POST /webhooks":"Register a new webhook","GET /webhooks/:id":"Get webhook details","PUT /webhooks/:id":"Update webhook","DELETE /webhooks/:id":"Delete webhook","POST /webhooks/:id/test":"Test webhook with sample event","GET /webhooks/:id/log":"Get webhook delivery history"},"webhook_config":{"url":"Required - HTTPS endpoint to receive events","secret":"Optional - HMAC secret for signature verification","types":"Array of event types to subscribe to","severities":"Array of severity levels (default: severe, extreme)","modes":"Array of transport modes to filter","states":"Array of US state codes to filter","ports":"Array of port names to filter"},"filters":{"type":"weather | port | vessel | rail | geopolitical","severity":"info | warning | severe | extreme (comma-separated for multiple)","modes":"ocean | trucking | rail | air (comma-separated)","region":"State code or country name","port":"Port name","limit":"Max results (default 100)","active":"true/false - include expired events (default true = active only)"},"examples":["/events?type=weather&severity=severe,extreme","/events?modes=ocean&region=CA","/events?port=Los%20Angeles"],"sources":[{"name":"NOAA NWS","type":"weather","url":"https://api.weather.gov"},{"name":"BTS Freight Indicators","type":"port, rail","url":"https://bts.gov/freight-indicators"},{"name":"AISStream","type":"vessel","url":"https://aisstream.io"},{"name":"GDELT","type":"geopolitical","url":"https://gdeltproject.org"},{"name":"FreightWaves RSS","type":"geopolitical","url":"https://freightwaves.com"},{"name":"Supply Chain Dive RSS","type":"geopolitical","url":"https://supplychaindive.com"}],"pricing":"FREE - all data from public sources"}