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-2026

Chiave 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.

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
}

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.

GET /api/v1/editorial/AF/light

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.

GET /api/v1/editorial

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

CodiceHTTPSignificato
UNAUTHORIZED401Chiave API mancante o non valida
FORBIDDEN403Chiave revocata
NOT_FOUND404Scheda editoriale non trovata
RATE_LIMITED429Quota 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.

API FareTag per sviluppatori — Documentazione