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-2026Cle 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.
{
"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.
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.
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
| Code | HTTP | Signification |
|---|---|---|
| UNAUTHORIZED | 401 | Cle API manquante ou invalide |
| FORBIDDEN | 403 | Cle revoquee |
| NOT_FOUND | 404 | Fiche editoriale non trouvee |
| RATE_LIMITED | 429 | Quota 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.