公开API V1

集成FareTag引擎

通过API访问评级引擎和编辑数据库。对您自己的票价数据进行评分，或查询我们的已核实条件数据库。

身份验证

每个请求均需包含X-Api-Key请求头。可使用演示密钥进行测试：

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

演示密钥：每天25次请求。如需生产环境使用，请通过下方联系我们。

数据边界

API不对外暴露第三方预订数据（价格、可用性、报价）。引擎对您的数据进行评分，编辑内容归我们所有。

POST /api/v1/verdict

发送结构化票价条件，接收完整评级结果。零出站网络请求，零第三方依赖。

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
}

响应：

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

返回指定航空公司和票价系列的FareTag编辑信息页，含计算所得的评级结果和有日期的数据来源。

GET /api/v1/editorial/AF/light

如航空公司或票价系列未被收录，返回404。

GET /api/v1/editorial

覆盖范围列表：所有已记录的航空公司和票价系列，含最后核实日期。

GET /api/v1/editorial

可嵌入徽章

在任何销售机票的地方展示FareTag等级。服务器端生成的SVG徽章，已缓存，链接到航空公司信息页。

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

错误代码

代码	HTTP	含义
UNAUTHORIZED	401	API密钥缺失或无效
FORBIDDEN	403	密钥已撤销
NOT_FOUND	404	未找到编辑信息页
RATE_LIMITED	429	已超出每日配额

测试沙盒

使用演示密钥测试引擎。选择条件并运行评分。

退款

改签

行李

授权许可

每月起价150欧元。自定义配额、技术支持、SLA。请联系我们讨论您的使用场景。

返回首页