HTTP routes
This page lists the main deployed HTTP surface. SQS-driven local replay harnesses are documented on the relevant service pages and in OpenAPI with x-drive-deployment: local-test-http.
Auth key
| Marker | Meaning |
|---|---|
| API key | Requires X-Api-Key at API Gateway. |
| Public | private: false in serverless.yml; handler may still perform its own token/signature checks. |
| Local harness | HTTP-shaped local replay path; deployed trigger is SQS or another event source. |
Route groups
| Service | Deployed HTTP operations | Local harnesses | Primary purpose |
|---|---|---|---|
| ads | 1 | 0 | Tagless ad payload generation. |
| autograb | 10 | 0 | Vehicle lookup, price gauge, residuals, valuation. |
| cachewarm | 2 | 0 | Cache-warm schedule creation and queueing. |
| canbus | 2 | 0 | Queue and write CAN bus/Timestream events. |
| cfs | 3 | 0 | Cars-for-sale external list and counts. |
| cloudflare | 1 | 0 | Add Cloudflare redirection. |
| geo | 2 | 0 | Country and city GeoIP lookup. |
| leads | 13 | 8 | Lead ingestion, config, public webhooks, queue entry points. |
| marketing | 6 | 1 | Insider contact/subscription/transactional email. |
| marketplace | 8 | 0 | Utility endpoints for marketplace colours, phone, click-to-call, finance, insurance. |
| ml | 1 | 0 | Image labels. |
| oly | 1 | 0 | Lease calculator. |
| purge | 6 | 0 | Cache purges, transitions, PurgeBot. |
| root | 1 | 0 | robots.txt. |
| social | 4 | 0 | Disqus and sharedcount.com counts. |
| syndication | 4 | 0 | Google/Facebook indexing and syndication feeds. |
| udp | 1 | 0 | Snowflake proxy. |
High-risk route notes
| Service | Path | Note |
|---|---|---|
| leads | /leads/in/fb/queue | Public Facebook webhook. GET is verification; POST ingests leadgen events. |
| leads | /leads/in/process, /leads/out/* workers | Local HTTP harnesses only for most worker processors; deployed execution is SQS. |
| marketing | /marketing/email/transactional/process | Local HTTP harness only; deployed execution is SQS from the transactional email queue. |
| purge | /post/transition | Validation failures intentionally return 200 with result: "rejected". |
| purge | /purge/bot | Public Slack receiver; handler validates URL and allowed Slack handles before queueing. |
| social | /social/sharecount | API Gateway method is ANY; GET and POST are both documented. |
| social | /social/commentcount, /social/sharecount-bulk | Handlers contain POST branches, but only GET is mounted in serverless.yml. |
Full operation detail
Use the per-service Scalar pages for complete request and response schemas:
To regenerate static docs and validate route/spec drift:
cd docs/site
yarn build