API PUBBLICA V1
Integri il motore FareTag
Il motore di verdetto e la base editoriale, accessibili tramite API. Calcoli il punteggio dei propri dati tariffari o interroghi la nostra base di condizioni verificate.
Autenticazione
Ogni richiesta richiede un header X-Api-Key. Una chiave demo è disponibile per i test:
X-Api-Key: faretag-demo-key-2026Chiave demo: 25 richieste/giorno. Per un utilizzo in produzione, ci contatti qui sotto.
Confine dei dati
L'API non espone mai dati di prenotazione di terze parti (prezzi, disponibilità, offerte). Il motore calcola il punteggio dei suoi dati, l'editoriale è nostro.
POST /api/v1/verdict
Invii condizioni tariffarie strutturate, riceva un verdetto completo. Zero rete in uscita, zero dipendenze esterne.
{
"refund": { "status": "allowed_with_fee", "fee": { "amount": 50, "currency": "EUR" } },
"change": { "status": "not_allowed" },
"baggage": { "checked_included": 1, "status": "known" },
"fare_total": 400
}Risposta:
{
"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}
Restituisce la scheda editoriale FareTag per una compagnia e una famiglia tariffaria, con verdetto calcolato e provenienza datata.
404 se la compagnia o la famiglia non è coperta.
GET /api/v1/editorial
Elenco di copertura: tutte le compagnie e famiglie documentate, con data dell'ultima verifica.
Badge incorporabile
Mostri il grado FareTag ovunque si venda un biglietto. Badge SVG generato lato server, memorizzato in cache, collegato alla scheda compagnia.
<a href="https://faretag.com/compagnies/AF/light">
<img src="https://faretag.com/api/badge/AF/light.svg"
alt="Conditions verified by FareTag" />
</a>Codici di errore
| Codice | HTTP | Significato |
|---|---|---|
| UNAUTHORIZED | 401 | Chiave API mancante o non valida |
| FORBIDDEN | 403 | Chiave revocata |
| NOT_FOUND | 404 | Scheda editoriale non trovata |
| RATE_LIMITED | 429 | Quota giornaliera superata |
Playground
Testi il motore con la chiave demo. Selezioni le condizioni e avvii il calcolo del punteggio.
Licenza
A partire da 150 EUR/mese. Quota personalizzata, supporto tecnico, SLA. Ci contatti per discutere del suo caso d'uso.