API
Catalog
Walk makes → models → years → variants → views, or search with q=.
Only published vehicles in your contract categories are visible. Authenticate with x-api-key.
Makes
curl -H "x-api-key: YOUR_KEY" \
"$APP_URL/v1/makes"{ "makes": [{ "id": "…", "slug": "daf", "name": "DAF" }] }Models for a make
curl -H "x-api-key: YOUR_KEY" \
"$APP_URL/v1/makes/daf/models"(Equivalent: $APP_URL/v1/makes/daf.)
Years for a model
curl -H "x-api-key: YOUR_KEY" \
"$APP_URL/v1/makes/daf/models/xf"Returns { make, model, years } with years newest first.
Vehicle and views for a year
curl -H "x-api-key: YOUR_KEY" \
"$APP_URL/v1/makes/daf/models/xf/2022"- One published variant in your categories:
{ make, model, vehicle, views } - Several variants:
{ make, model, year, variants }— pick avariantslug, then request views:
curl -H "x-api-key: YOUR_KEY" \
"$APP_URL/v1/makes/daf/models/xf/2022/{variant}"views is the list of published camera ids for that vehicle (subset of the nine studio views).
Search
curl -H "x-api-key: YOUR_KEY" \
"$APP_URL/v1/search?q=daf+xf+2022"results entries include make, makeSlug, model, modelSlug, year, variant, and category. Filtered to your contract.
Colors and views (reference)
curl -H "x-api-key: YOUR_KEY" "$APP_URL/v1/colors"
curl -H "x-api-key: YOUR_KEY" "$APP_URL/v1/views"Named colors (hex is accepted on image requests too):
| Name | Hex |
|---|---|
red | #C41E3A |
blue | #1E4B8C |
green | #2E7D32 |
white | #F5F5F5 |
black | #1A1A1A |
silver | #C0C0C0 |
yellow | #F5C518 |
orange | #E85D04 |
Studio view ids:
| Id | Label |
|---|---|
front_left | Front left |
front | Front |
front_right | Front right |
side_right | Side right |
rear_right | Rear right |
rear | Rear |
rear_left | Rear left |
side_left | Side left |
top_down | Top down |
Continue to Images to request a signed render.