GET https://compatair.fr/api/v1/compatibilityConsultation uniquement, limitée à 120 requêtes par minute et par adresse. Une offre professionnelle pourra prévoir un autre volume, une assistance et un historique distinct.Périmètre du catalogue et calcul à la demande
103 628 833 combinaisons sont explorables : 5159 compresseurs × 20087 outils. Ce nombre n’est pas celui des verdicts pré-calculés. Le manifeste /data/verdicts.json, en schéma 2.0.0, décrit 45 755 171 couples à débit fixe calculables pour 8869 outils à débit fixe. Les 11218 autres outils représentent 57 873 662 combinaisons paramétriques. L’endpoint HTTP par identifiants répond insufficient_data pour ces outils ; les besoins par action ou de gonflage exigent leurs paramètres, tandis que les fiches incomplètes doivent être complétées par des données constructeur.
L’audit exhaustif publié le 2026-09-27 était conclusif à 9,9 % : 78 120 compatibles en continu, 379 107 incompatibles et 4 143 279 insuffisants. La part d’incompatibilités mesure le filtrage d’un corpus inter-marques large, pas la performance opérationnelle de l’API.
Migration : le manifeste courant ne contient plus de tableau pairs. Pour une décision actuelle, utiliser l’API avec les identifiants du catalogue courant. L’archive conserve les octets du schéma 1.1.0 et son catalogue associé, vérifiables avec ses signatures d’origine. Ses résultats sont historiques.
Requête
curl --get 'https://compatair.fr/api/v1/compatibility' \
--data-urlencode 'compressorId=einhell-tc-ac-240-50-10-of' \
--data-urlencode 'toolId=einhell-tc-pe-150'Contenu de la réponse
- enveloppe commune avec
verdict,verdict_scope,canonical_url, sources, versions, date, limites et actions suivantes ; air_supply_verdictpour pression, FAD et cycle, séparé d’overall_system_verdictpour le système complet ;- vocabulaire moteur conservé dans
engine_verdictsans devenir un second verdict ambigu ; - FAD requis, FAD disponible, raison d’une éventuelle limite et avertissements lorsque ces données existent ;
- sources datées, reçu de compatibilité vérifiable, calculateur prérempli et graphe de preuve prérempli.
Surface publique
GET /api/v1/compatibility: décision pour une paire identifiée.GET /api/v1/search: recherche plein texte dans les guides, produits et définitions publiés.GET /api/v1/search/catalog: recherche de références avec pagination liée à la version du catalogue.GET /api/v1/search/products: lecture de 1 à 50 références exactes ;catalogVersionempêche de mélanger deux publications.GET /api/v1/search/identify: correspondances exactes et signal explicite d’ambiguïté.GET /api/v1/evidence: caractéristiques, documents et arêtes AirGraph utilisés.GET /api/v1/changefeed: versions protocole, méthode, catalogue, preuves, connaissances et offres.POST /api/v1/compatibility/receipts/verify: vérification d’intégrité d’un reçu, sans stockage ni téléchargement des URL incluses.POST /api/ucp/v1/compatibility/evaluate: décision UCP sur une configuration complète, sans mutation commerciale.
Le contrat intégral est disponible dans l’OpenAPI public. La capability UCP possède aussi son OpenAPI spécialisé, son binding OpenRPC et son JSON Schema.
Erreurs et limites
L’API refuse les identifiants inconnus, les paramètres non prévus ou dupliqués et les tentatives de modification. Un cache vide déclenche le calcul déterministe avec les produits et le moteur de la publication active. Une référence inconnue reste une erreur 404 ; un champ technique manquant produit une réponse explicite avec données insuffisantes. Les lectures de références avec une version périmée répondent 409 : le client doit recharger la publication. Une indisponibilité ne doit jamais être transformée côté client en verdict positif.
Intégration dans un site web
Un navigateur peut consulter cette adresse depuis un autre domaine, sans cookie. C’est ce que signifie l’autorisation technique CORS. L’API ne reçoit ni photographie, ni configuration d’atelier, ni donnée personnelle.
Données publiques de qualité
Le snapshot catalogue publie les identifiants normalisés et un rapport de couverture champ par champ : présence, source explicitement liée, source primaire et corroboration indépendante. L’EAN/GTIN, le MPN normalisé et les SKU distributeur y conservent leurs dénominateurs ; un SKU absent reste absent.
L’Observatoire de la qualité documentaire publie un snapshot versionné. Le radar des contradictions conserve séparément chaque valeur et sa décision documentaire. Les distributions NDJSON, le manifeste de fraîcheur avec SLA par type de donnée, les empreintes SHA-256 et le catalogue DCAT 3 rendent la surface auditable par machine.