# 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.