API PUBLIQUE V1

Integrez le moteur FareTag

Le moteur de verdict et la base editoriale, accessibles par API. Scorez vos propres donnees tarifaires ou interrogez notre base de conditions verifiees.

Authentification

Chaque requete necessite un header X-Api-Key. Une cle demo est disponible pour tester :

X-Api-Key: faretag-demo-key-2026

Cle demo : 25 requetes/jour. Pour un usage en production, contactez-nous ci-dessous.

Frontiere de donnees

L'API n'expose jamais de donnees de reservation tierces (prix, disponibilites, offres). Le moteur score vos donnees, l'editorial est le notre.

POST /api/v1/verdict

Envoyez des conditions tarifaires structurees, recevez un verdict complet. Zero reseau sortant, zero dependance tierce.

POST /api/v1/verdict
{
  "refund": { "status": "allowed_with_fee", "fee": { "amount": 50, "currency": "EUR" } },
  "change": { "status": "not_allowed" },
  "baggage": { "checked_included": 1, "status": "known" },
  "fare_total": 400
}

Reponse :

{
  "grade": "C",
  "score": 53,
  "capApplied": null,
  "unknownCount": 0,
  "axes": [
    { "id": "refund", "label": "refundPenalty", "points": 31, "maxPoints": 40 },
    { "id": "change", "label": "changeNone", "points": 0, "maxPoints": 30 },
    { "id": "baggage", "label": "baggageIncluded", "points": 15, "maxPoints": 15 },
    { "id": "data", "label": "dataComplete", "points": 15, "maxPoints": 15 }
  ],
  "engineVersion": "v2"
}

GET /api/v1/editorial/{iata}/{fareBrand}

Retourne la fiche editoriale FareTag pour une compagnie et une famille tarifaire, avec verdict calcule et provenance datee.

GET /api/v1/editorial/AF/light

404 si la compagnie ou la famille n'est pas couverte.

GET /api/v1/editorial

Liste de couverture : toutes les compagnies et familles documentees, avec date de derniere verification.

GET /api/v1/editorial

Badge embarquable

Affichez le grade FareTag partout ou un billet se vend. Badge SVG genere serveur, mis en cache, lie a la fiche compagnie.

<a href="https://faretag.com/compagnies/AF/light">
  <img src="https://faretag.com/api/badge/AF/light.svg"
       alt="Conditions verified by FareTag" />
</a>

Codes d'erreur

CodeHTTPSignification
UNAUTHORIZED401Cle API manquante ou invalide
FORBIDDEN403Cle revoquee
NOT_FOUND404Fiche editoriale non trouvee
RATE_LIMITED429Quota journalier depasse

Playground

Testez le moteur avec la cle demo. Selectionnez des conditions et lancez le scoring.

Licence

A partir de 150 EUR/mois. Quota sur mesure, support technique, SLA. Contactez-nous pour discuter de votre cas d'usage.

API FareTag pour developpeurs — Documentation