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

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

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
}

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.

GET /api/v1/editorial/AF/light

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.

GET /api/v1/editorial

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ódigoHTTPSignificado
UNAUTHORIZED401Clave API faltante o inválida
FORBIDDEN403Clave revocada
NOT_FOUND404Ficha editorial no encontrada
RATE_LIMITED429Cuota 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.

API FareTag para desarrolladores — Documentación