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 du snapshot
22 400 combinaisons sont explorables : 140 compresseurs × 160 outils. Ce nombre n’est pas celui des verdicts pré-calculés. Le snapshot /data/verdicts.json contient 20 860 verdicts fixes audités pour 149 outils à débit fixe. Les 11 autres outils représentent 1 540 combinaisons paramétriques. L’endpoint HTTP par identifiants répond insufficient_data pour ces outils ; le calculateur, MCP ou UCP doit recevoir une cadence ou un volume et un temps cible.
Le snapshot fixe est conclusif à 96 % : 7 014 compatibles en continu, 13 022 incompatibles et 824 insuffisants. La part d’incompatibilités mesure le filtrage d’un corpus inter-marques large, pas la performance opérationnelle de l’API.
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/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. Si un résultat manque dans la copie datée du catalogue, elle renvoie une erreur explicite au lieu d’utiliser un autre calcul. 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.