API PÚBLICA V1

Integre o motor FareTag

O motor de veredicto e a base editorial, acessíveis por API. Pontue seus próprios dados tarifários ou consulte nossa base de condições verificadas.

Autenticação

Cada requisição requer um cabeçalho X-Api-Key. Uma chave demo está disponível para testes:

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

Chave demo: 25 requisições/dia. Para uso em produção, entre em contato conosco abaixo.

Fronteira de dados

A API nunca expõe dados de reserva de terceiros (preços, disponibilidades, ofertas). O motor pontua seus dados, o editorial é nosso.

POST /api/v1/verdict

Envie condições tarifárias estruturadas, receba um veredicto completo. Zero tráfego de saída, zero dependência de terceiros.

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
}

Resposta:

{
  "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}

Retorna a ficha editorial FareTag para uma companhia e família tarifária, com veredicto calculado e proveniência datada.

GET /api/v1/editorial/AF/light

404 se a companhia ou família não estiver coberta.

GET /api/v1/editorial

Lista de cobertura: todas as companhias e famílias documentadas, com data da última verificação.

GET /api/v1/editorial

Badge incorporável

Exiba a nota FareTag onde quer que um bilhete seja vendido. Badge SVG gerado no servidor, em cache, vinculado à ficha da companhia.

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

Códigos de erro

CódigoHTTPSignificado
UNAUTHORIZED401Chave de API ausente ou inválida
FORBIDDEN403Chave revogada
NOT_FOUND404Ficha editorial não encontrada
RATE_LIMITED429Cota diária excedida

Playground

Teste o motor com a chave demo. Selecione condições e execute a pontuação.

Licença

A partir de 150 EUR/mês. Cota personalizada, suporte técnico, SLA. Entre em contato para discutir seu caso de uso.

API FareTag para desenvolvedores — Documentação