API PÚBLICA V1
Integre el motor FareTag
El motor de veredicto y la base editorial, accesibles por API. Puntúe sus propios datos tarifarios o consulte nuestra base de condiciones verificadas.
Autenticación
Cada solicitud requiere un encabezado X-Api-Key. Hay disponible una clave de demostración para pruebas:
X-Api-Key: faretag-demo-key-2026Clave de demostración: 25 solicitudes/día. Para uso en producción, contáctenos a continuación.
Frontera de datos
La API no expone nunca datos de reservas de terceros (precios, disponibilidades, ofertas). El motor puntúa sus datos, la editorial es nuestra.
POST /api/v1/verdict
Envíe condiciones tarifarias estructuradas, reciba un veredicto completo. Cero red de salida, cero dependencia de terceros.
{
"refund": { "status": "allowed_with_fee", "fee": { "amount": 50, "currency": "EUR" } },
"change": { "status": "not_allowed" },
"baggage": { "checked_included": 1, "status": "known" },
"fare_total": 400
}Respuesta:
{
"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}
Devuelve la ficha editorial FareTag para una aerolínea y una familia tarifaria, con veredicto calculado y procedencia fechada.
404 si la aerolínea o la familia no está cubierta.
GET /api/v1/editorial
Lista de cobertura: todas las aerolíneas y familias documentadas, con la fecha de la última verificación.
Insignia integrable
Muestre la nota FareTag en cualquier lugar donde se venda un billete. Insignia SVG generada en servidor, en caché, enlazada a la ficha de la aerolínea.
<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 error
| Código | HTTP | Significado |
|---|---|---|
| UNAUTHORIZED | 401 | Clave API faltante o inválida |
| FORBIDDEN | 403 | Clave revocada |
| NOT_FOUND | 404 | Ficha editorial no encontrada |
| RATE_LIMITED | 429 | Cuota diaria superada |
Playground
Pruebe el motor con la clave de demostración. Seleccione condiciones e inicie la puntuación.
Licencia
A partir de 150 EUR/mes. Cuota a medida, soporte técnico, SLA. Contáctenos para hablar de su caso de uso.