パートナーAPI
WinkのパートナーAPIは、認証された高スループットの方法で、統合者が予約可能な旅行在庫を照会できるものです。これは、埋め込み可能なウィジェットや公開ブラウズエンドポイントを支える同じ供給を、第一級のプログラムインターフェースとして公開しています。無料のWebコンポーネントや公開ブラウズエンドポイントは軽量で人間向けの埋め込みを目的としていますが、パートナーAPIは大規模に検索、価格設定、予約を行うシステム向けに構築されています。アクセスは統合者ごとに認証され、使用量に応じて課金されるため、実際に送信したトラフィック分だけ支払います。
プランと料金
Section titled “プランと料金”1回のAPIコール = 1リクエスト。使用量は1,000リクエスト単位で課金されます。
| 無料 | 有料 | エンタープライズ | |
|---|---|---|---|
| 価格 | $0 | 使用量に基づく | お問い合わせください |
| 最適な用途 | 評価および低ボリューム統合 | 大規模な従量課金スループット | カスタムボリューム＆交渉条件 |
| 1分あたりのリクエスト数 | 30（バースト60） | 無制限 | 無制限 |
| 1か月あたりのリクエスト数 | 10,000 | 無制限 | 無制限 |
| API応答時間（P95） | — | 500ms未満 | 500ms未満 |
| 1,000リクエストあたりの価格 | 無料 | $1.00 | カスタム |
| ルック・トゥ・ブック超過料金（5,000:1を超える1,000ルックあたり） | — | $2.00 | カスタム |
| レート制限応答 | 429（停止 / 月間ハードストップ） | なし | なし |
| サービスレベル契約 | — | ✓ | ✓ |
| 優先サポート | — | ✓ | ✓ |
| 専用オンボーディング | — | — | ✓ |
APIキーを取得 · 従量課金を開始 · 営業に問い合わせる
APIリファレンス
Section titled “APIリファレンス”予約可能な在庫を提供する2つのインターフェースがあり、上記の2つのプランに対応しています：
- 無料 — コンシューマー / 予約エンジンAPI（REST、
/api/public/**）：匿名、ブラウザおよびウィジェット向け。予約エンジンリファレンスを見る → - 有料 — パートナー統合API（gRPC、
wink.partner.v1）：認証済み、使用量計測、サーバー間統合向け。統合者リファレンスを見る →
パートナー統合APIはgRPCであり、RESTではありません。HTTP/2経由で生成されたクライアントを使い、
partner.wink.travel:443にベアラートークンと呼び出すアカウントを渡して呼び出します：
grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list上記のリファレンスページにはすべてのサービス、メッセージ、エラーステータスが記載されており、スキーマはサーバーリフレクションを通じて実行時にも利用可能なため、grpcurl、Postman、Insomniaは何もダウンロードせずに検出できます。
事前にクライアントを生成したい場合は、.protoソースファイルが
github.com/wink-travel/partner-api-protoで公開されています。
使用量と制限の仕組み
Section titled “使用量と制限の仕組み”無料プランは、構築、テスト、そして控えめな本番トラフィックの運用を無償で行えるよう設計されています。
- レート制限 — 1分あたり30リクエスト、バースト60リクエスト。 持続的なレートを超える短期的なスパイクはバースト許容量で吸収されます。超過するとAPIは**HTTP 429（リクエスト過多）**で応答し、5分間の停止が適用され、その後キーがトラフィックを再開します。停止期間後にリトライし、エンドポイントを叩き続けるのは避けてください。
- 月間クォータ — カレンダー月あたり10,000リクエスト。 月間上限に達すると、APIは月末までHTTP 429を返し、継続利用には有料プランへの加入を促すメッセージを表示します。カウンターは翌月初めにリセットされます。
無料プランにはサービスレベル契約や優先サポートは含まれません。
有料プランは月間上限とレート制限の停止を解除し、使用量に応じてのみ課金されます。
-
従量課金 — 1,000リクエストあたり$1.00。 月間リクエスト上限はなく、通常使用下でのレート制限もありません。実際の使用量に基づいて課金されます。
-
ルック・トゥ・ブック超過料金 — 1,000ルックあたり$2.00。 供給の健全性を保つため、検索数（「ルック」）と確定予約数の比率を計測します。超過料金は1予約あたり5,000ルックまで無料で、それを超えた分は以下の式で計算されます：
excess = max(0, looks − bookings × 5,000)超過分は1,000ルックあたり$2.00で課金されます。コンバージョン率の高い統合ではほとんど超過料金は発生しません。超過料金は予約数に比べて検索が極端に多いトラフィックにのみ適用されます。
有料プランには以下に記載のサービスレベル契約（99.9%の稼働率保証とP95応答時間500ms未満の目標）および優先度・重大度に基づくサポートが含まれます。
サービスレベル契約
Section titled “サービスレベル契約”発効日：2026年7月5日 · バージョン1.0
本サービスレベル契約（以下「SLA」）は、Wink（「Wink」、「当社」）が認証済みWinkパートナーAPI（「パートナーAPI」または「サービス」）に対して、SLA適用プランの顧客（「顧客」、「あなた」）に提供する可用性コミットメント、サービスクレジット、およびサポート目標を定めるものです。本SLAは、あなたとWink間のパートナーAPI利用契約（「契約」）に組み込まれ、かつこれに準拠し、あなたが有効な有料パートナーAPIサブスクリプションを維持している限り適用されます。ここで定義されていない大文字の用語は契約で定義された意味を持ちます。
- **「稼働時間」**とは、パートナーAPIが適切に形成され認証されたリクエストを受け入れ、正常に応答できる期間を指します。
- **「停止時間」**とは、パートナーAPIが適切に形成され認証されたリクエストに正常に応答できなかった期間（分単位）を指し、セクション4の除外事項に該当する期間は含みません。影響がごく一部のリクエストに限られる単発のエラーは停止時間に含まれません。
- **「月間稼働率」**とは、特定のカレンダー月におけるその月の総分数から停止時間の分数を差し引いたものを、その月の総分数で割った割合（パーセンテージ）を指します。
- **「予定メンテナンス」**とは、Winkが事前通知を行ったサービスの計画的メンテナンスを指し、セクション4に従います。
- **「サービスクレジット」**とは、稼働率コミットメントを満たせなかった場合に、当該月にあなたが支払ったまたは支払うべきパートナーAPI料金の一定割合として計算され、将来のパートナーAPI料金に充当される唯一かつ排他的な救済措置です。
- **「応答時間」**とは、Winkのサービス境界で適切に形成され認証されたリクエストを受け取ってから、Winkが応答の返送を開始するまでの経過時間を指し、ネットワーク遅延やクライアント側の時間は含みません。
2. 可用性およびパフォーマンスコミットメント
Section titled “2. 可用性およびパフォーマンスコミットメント”Winkは、契約期間中の各カレンダー月において、パートナーAPIの月間稼働率を99.9%以上に維持するよう商業的に合理的な努力を行います（「稼働率コミットメント」）。稼働率コミットメントはWinkのサービス境界で測定され、セクション4に記載のWinkの合理的な管理外の要因は除外されます。Winkの監視システムが月間稼働率および応答時間の公式な記録源です。
さらに、Winkは各カレンダー月において、正常で適切に形成された認証済みリクエストの95パーセンタイル（P95）応答時間を500ミリ秒未満に抑えることを目標とします（「パフォーマンス目標」）。パフォーマンス目標はセクション4の要因、リクエスト自身の原因によるアプリケーションレベルのエラー、異常に大きいまたは複雑なバッチリクエストを除外します。パフォーマンス目標はサービス目標であり、セクション3のサービスクレジットは稼働率コミットメントの不達成に対する唯一かつ排他的な救済措置です。
3. サービスクレジット
Section titled “3. サービスクレジット”月間稼働率が稼働率コミットメントを下回った場合、当該月にあなたが支払ったまたは支払うべきパートナーAPI料金の割合に応じて以下の表に基づくサービスクレジットを受け取る資格があります：
| 月間稼働率 | サービスクレジット |
|---|---|
| 99.9%未満かつ99.0%以上 | 10% |
| 99.0%未満かつ95.0%以上 | 25% |
| 95.0%未満 | 50% |
- クレジット請求方法。 サービスクレジットを受け取るには、停止が発生したカレンダー月の終了から30日以内にWinkに書面で請求を提出する必要があります。請求には、停止事象の日時および合理的に入手可能なログや証拠を含めてください。この期間を過ぎた請求は対象外です。
- クレジットの形態。 承認されたサービスクレジットは将来のパートナーAPI料金に充当され、現金価値はありません。返金ではなく、適用法令で要求される場合を除き支払われません。
- 最大クレジット額。 1カ月あたりのサービスクレジットの合計は、その月にあなたが支払ったまたは支払うべきパートナーAPI料金の50%を超えません。
- 唯一かつ排他的な救済。 サービスクレジットは、Winkが稼働率コミットメントを満たさなかった場合の唯一かつ排他的な救済措置です。
4. 除外事項
Section titled “4. 除外事項”稼働率コミットメントおよびサービスクレジットは、以下に起因または関連するサービスの利用不可、停止、劣化、パフォーマンス問題には適用されず、停止時間にも含まれません：
- Winkが事前通知した予定メンテナンス（合理的な期間前に通常の連絡チャネルで通知されたもの）；
- 自然災害、政府の行為、ネットワークやユーティリティの障害、サービス拒否攻撃など、Winkの合理的管理外の不可抗力事象；
- あなたの行為または不作為、あなたの機器、ソフトウェア、ネットワーク、またはWinkの直接管理外の第三者サービス、製品、プロバイダーによる問題；
- あなたのサービスの乱用や契約違反、本SLA、許容使用条件、適用されるレート制限の違反、過剰なトラフィック、ボットによる乱用、不正行為とWinkが合理的に判断するもの；
- 契約に基づき適切に実施されたあなたのアクセスの停止または終了（未払いによる停止を含む）。
5. サポートおよび応答目標
Section titled “5. サポートおよび応答目標”Winkは標準営業時間内（現地の祝日を除く）にパートナーAPIのサポートを提供します。Winkは、あなたが割り当てた重大度に基づき、合理的に確認した上で、以下の目標応答時間内に適切に提出されたサポートリクエストに対して初回応答を行うよう商業的に合理的な努力をします：
| 重大度 | 説明 | 目標初回応答時間 |
|---|---|---|
| Sev 1 — 重大 | パートナーAPIが本番環境でダウンまたは使用不能で、回避策なし。 | 4時間 |
| Sev 2 — 主要 | 重要な機能が障害または劣化しているが回避策あり。 | 1営業日 |
| Sev 3 — 軽微 | 一般的な質問、軽微な問題、機能要望。 | 2営業日 |
目標応答時間は初回連絡の目標であり、解決時間の保証ではありません。優先サポートおよび重大度に基づく目標は、該当プランで提供されます。
6. データおよびセキュリティ
Section titled “6. データおよびセキュリティ”Winkは、パートナーAPIを通じて処理されるデータの機密性、完全性、可用性を保護するために商業的に合理的な管理的、技術的、組織的措置を維持し、定期的に見直します。Winkの個人データ処理はプライバシーポリシーおよび契約のデータ処理条項に準拠します。あなたは自身のAPI認証情報の保護、取得したデータの合法的な使用、および認証情報の侵害が疑われる場合の速やかなWinkへの通知に責任を負います。
7. 責任の制限
Section titled “7. 責任の制限”サービスクレジットは、稼働率コミットメントの不達成に対する唯一かつ排他的な救済措置であり、それに起因するその他の責任に代わるものです。本SLAに明示的に記載されている場合を除き、パートナーAPIは「現状有姿」で提供されます。適用法の最大限許容範囲内で、Winkのサービスに関する総責任は契約に定める範囲に限定され、間接的、偶発的、特別、結果的、懲罰的損害や利益、収益、データ、信用の損失については、たとえその可能性を知らされていても責任を負いません。
8. 契約期間、変更および終了
Section titled “8. 契約期間、変更および終了”本SLAは、SLA適用プランの有効なパートナーAPIサブスクリプションを保持している限り適用されます。Winkは本SLAを随時更新することがあり、重要な変更は通常顧客に連絡するチャネルを通じて通知されます。更新後のパートナーAPIの継続利用は更新されたSLAの承諾を意味します。本SLAは契約またはパートナーAPIサブスクリプションの終了または満了により自動的に終了します。終了後も性質上存続すべき条項（未請求のサービスクレジット資格、責任制限、定義など）は存続します。