AeroModel

AeroModel

Documentation

GET /v1/resolve

Resolves a raw identifier (slug, IATA, ICAO, or fuzzy name) into its canonical entry. Useful to validate user input client-side before building an image URL.

Parameters

ParamRequiredValues
kind✅plane or airline
method✅raw (auto-detect), iata (strict), icao (strict)
value✅The string to resolve

Examples

Resolve an aircraft by free string

GET https://api.aeromodel.dash-systems.fr/v1/resolve?api-key=YOUR_KEY&kind=plane&method=raw&value=A320

{
  "kind": "plane",
  "method": "raw",
  "value": "A320",
  "matched": true,
  "item": {
    "slug": "airbus-a320-200",
    "name": "Airbus A320-200",
    "iata": "320",
    "icao": "A320"
  },
  "candidates": []
}

Resolve by strict IATA

GET https://api.aeromodel.dash-systems.fr/v1/resolve?api-key=YOUR_KEY&kind=airline&method=iata&value=AF

{
  "kind": "airline",
  "method": "iata",
  "value": "AF",
  "matched": true,
  "item": {
    "slug": "air-france",
    "name": "Air France",
    "iata": "AF",
    "icao": "AFR"
  }
}

No exact match

GET https://api.aeromodel.dash-systems.fr/v1/resolve?api-key=YOUR_KEY&kind=plane&method=raw&value=jumbo

{
  "matched": false,
  "candidates": [
    { "slug": "boeing-747-400", "score": 0.62 },
    { "slug": "boeing-777-300er", "score": 0.41 }
  ]
}

Errors

CodeCase
400kind, method, or value missing or invalid
401No API key

See also