vin-decoder

VIN Decoder API - decode any 17-character VIN using NHTSA vPIC

Live at: https://vin.leeworks.dev (once deployed) OpenAPI spec: openapi.yaml

Endpoints

Method	Path	Auth	Description
GET	/v1/decode?vin={vin}	Required	Decode a single VIN
POST	/v1/batch	Required	Decode up to 50 VINs
GET	/v1/health	None	Service health and cache stats

Auth = X-RapidAPI-Proxy-Secret header.

Local development

npm install node scripts/seed.js # optional: seed known VINs npm run dev # starts on localhost:3000

Tests

npm test

Environment variables

PORT (default 3000), DB_PATH (default ./data/vin_cache.db), RAPIDAPI_PROXY_SECRET (required in prod)

Deployment

Flux manifests: flux/vin-decoder/. Requires gitea-registry imagePullSecret and rapidapi-proxy-secret in vin-decoder namespace.