Contrat OpenAPI
Générez un client typé dans votre langage à partir du document OpenAPI, et validez vos requêtes avec.
STANDARDS OUVERTS
Une seule façon de décrire une voiture.
Ouverte à tous.
AVS, l'AutoUncle Vehicle Schema, est un JSON Schema ouvert et versionné pour décrire une voiture : ce qu'elle est, comment elle est construite et de quoi elle est équipée. Utilisez-le dans vos propres systèmes, validez-le dans sept langages et appuyez-vous sur une API qui partage le même modèle d'identité.
AVS · AUTOUNCLE VEHICLE SCHEMA
Uniquement des faits.
Chaque niveau, un fait distinct.
AVS a deux types de documents : un document de type décrit une voiture telle que construite, par exemple une BMW 320e G20 berline avec M Sport ; un document véhicule décrit une voiture physique de ce type, avec son VIN, son kilométrage au compteur, sa couleur et son historique. Sous licence Apache-2.0, sans aucune donnée de catalogue.
Des faits, pas des opinions
AVS dit ce qu'est la voiture. Ce qu'elle vaut et où elle est en vente ont leur place ailleurs.
L'inconnu est omis
Seuls la marque et le modèle sont obligatoires. Rien n'est deviné, et une absence doit être déclarée.
Tout système de codes
Chaque fiche du catalogue liste ses identifiants dans n'importe quel système, comme AutoUncle, Wikidata ou KBA HSN/TSN, sans qu'aucun ne soit privilégié.
Conventions européennes
Les unités font partie des noms de champs, les valeurs suivent le certificat de conformité européen (COC) et la norme WLTP, et pays, devises et VIN utilisent les codes ISO.
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"]
}
}
}LE MODÈLE D'IDENTITÉ
La même structure
que celle de notre API.
Marque, modèle, génération et phase, puis carrosserie et motorisation comme faits indépendants, et la finition, les packs et les options par leur nom. Nos API identifient les voitures selon le même chemin, de la marque et du modèle jusqu'à la génération, la motorisation et la finition, avec des identifiants stables que vous pouvez stocker dans AVS sous le schéma autouncle.
VALIDATEURS
Validez AVS
dans sept langages.
Chaque package regroupe le schéma et un validateur qui renvoie chaque erreur avec un JSON Pointer vers sa position. Les packages sont générés à partir du schéma, jamais écrits à la main, et leur version est toujours celle du schéma.
| Langage | Package | Valider |
|---|---|---|
| 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) |
L'API
Des standards à tous
les niveaux de l'API.
Problem details
Les erreurs sont des documents de problème RFC 9457 avec un code stable, un pointeur vers le champ et une correction suggérée.
Codes ISO
Pays ISO 3166, devises ISO 4217 et VIN ISO 3779, dans les requêtes comme dans les résultats.
Idempotente par conception
Chaque estimation accepte une clé d'idempotence : une requête relancée n'est jamais facturée deux fois.
MCP pour les agents
La même API sous forme d'outils pour agents IA, plus un skill d'intégration et un llms.txt pour les assistants de code.
CONSTRUISEZ DESSUS
Décrivez les voitures une fois.
Utilisez-les partout.
Lisez le schéma, générez un client à partir du contrat OpenAPI et estimez votre première voiture avec une clé de test gratuite.