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-2026Chave 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.
{
"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.
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.
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ódigo | HTTP | Significado |
|---|---|---|
| UNAUTHORIZED | 401 | Chave de API ausente ou inválida |
| FORBIDDEN | 403 | Chave revogada |
| NOT_FOUND | 404 | Ficha editorial não encontrada |
| RATE_LIMITED | 429 | Cota 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.