OpenAPI-kontrakt
Generera en typad klient i ditt språk från OpenAPI-dokumentet och validera anrop mot det.
ÖPPNA STANDARDER
Ett sätt att beskriva en bil.
Öppet för alla.
AVS, AutoUncle Vehicle Schema, är ett öppet, versionerat JSON Schema för att beskriva en bil: vad den är, hur den är byggd och vilken utrustning den har. Använd det i dina egna system, validera det i sju språk och bygg på ett API som använder samma identitetsmodell.
AVS · AUTOUNCLE VEHICLE SCHEMA
Bara fakta.
Varje nivå ett eget faktum.
AVS har två slags dokument: ett typdokument beskriver en bil så som den är byggd, till exempel en BMW 320e G20 sedan med M Sport; ett fordonsdokument beskriver en fysisk bil av den typen, med VIN-nummer, mätarställning, färg och historik. Licensierat under Apache-2.0, utan katalogdata.
Fakta, inte åsikter
AVS säger vad bilen är. Vad den är värd och var den säljs hör hemma någon annanstans.
Det okända utelämnas
Bara märke och modell är obligatoriska. Ingenting gissas, och det som saknas måste anges uttryckligen.
Valfritt kodsystem
Varje katalogpost anger sina ID:n i valfritt schema, till exempel AutoUncle, Wikidata eller KBA HSN/TSN, och inget av dem har företräde.
EU-konventioner
Enheter ingår i fältnamnen, värden följer EU:s intyg om överensstämmelse (CoC) och WLTP, och länder, valutor och VIN-nummer använder ISO-koder.
examples/type-bmw-320e-g20-m-sport.json
{
"avs": { "version": "0.3", "kind": "type" },
"identity": {
"brand": {
"name": "BMW",
"ids": [
{ "scheme": "autouncle", "value": "b-example0001" },
{ "scheme": "wikidata", "value": "Q26678" }
]
},
"model": {
"name": "3 Series",
"localNames": { "DK": "3-serie" }
},
"generation": { "name": "3 Series (G20/G21)", "code": "G20" },
"drivetrain": {
"name": "320e (204 Hp) Plug-in Hybrid Steptronic"
}
},
"specification": {
"powertrain": {
"energy": ["petrol", "electricity"],
"electrification": "phev",
"powerKw": 150, "torqueNm": 300
}
},
"equipment": {
"trim": {
"name": "M Sport",
"variations": ["M Sportpakke", "M-Sport"]
}
}
}IDENTITETSMODELLEN
Samma struktur
som vårt API identifierar efter.
Märke, modell, generation och fas, sedan kaross och drivlina som oberoende fakta, och utrustningsnivå, paket och tillval med namn. Våra API:er identifierar bilar längs samma väg, från märke och modell till generation, motorvariant och utrustningsnivå, med stabila ID:n som du kan spara i AVS under schemat autouncle.
VALIDERARE
Validera AVS
i sju språk.
Varje paket innehåller schemat och en validerare som returnerar varje fel med en JSON Pointer till platsen. Paketen genereras från schemat, skrivs aldrig för hand, och deras version är alltid densamma som schemats.
| Språk | Paket | Validera |
|---|---|---|
| Ruby | autouncle-avs | AVS.validate(doc) |
| TypeScript / JavaScript | @autouncle/avs | validate(doc) |
| Python | autouncle-avs | avs.validate(doc) |
| Go | github.com/AutoUncle/avs/packages/go | avs.Validate(b) |
| Java / JVM | com.autouncle:avs | Avs.validate(json) |
| .NET | AutoUncle.Avs | AvsSchema.Validate(json) |
| PHP | autouncle/avs | Avs::validate($doc) |
API:ET
Standarder hela vägen
ned genom API:et.
Problem details
Fel är problemdokument enligt RFC 9457 med en stabil kod, en hänvisning till fältet och ett förslag på åtgärd.
ISO-koder
Länder enligt ISO 3166, valutor enligt ISO 4217 och VIN-nummer enligt ISO 3779, i anrop och resultat.
Idempotent från grunden
Varje värdering tar en idempotensnyckel, så att ett upprepat anrop aldrig debiteras två gånger.
MCP för agenter
Samma API som verktyg för AI-agenter, plus en integrationsskill och llms.txt för kodassistenter.
BYGG VIDARE PÅ DET
Beskriv bilar en gång.
Använd dem överallt.
Läs schemat, generera en klient från OpenAPI-kontraktet och värdera din första bil med en gratis testnyckel.