公開API V1
FareTagエンジンを統合する
APIでアクセス可能な評価エンジンと編集データベース。自分の運賃データをスコアリングしたり、確認済み条件のデータベースを照会したりできます。
認証
すべてのリクエストにはX-Api-Keyヘッダーが必要です。テスト用のデモキーが利用可能です：
X-Api-Key: faretag-demo-key-2026デモキー：1日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 | 1日のクォータを超過 |
プレイグラウンド
デモキーでエンジンをテストしてください。条件を選択してスコアリングを実行します。
ライセンス
月150 EURから。カスタムクォータ、テクニカルサポート、SLA。ユースケースについてご相談ください。