パートナーAPI
WinkのパートナーAPIは、認証された高スループットの方法で、統合者が予約可能な旅行在庫を照会できる手段です。これは、埋め込み可能なウィジェットや公開ブラウズエンドポイントを支える同じ供給元であり、ファーストクラスのプログラムインターフェースとして提供されます。無料のWebコンポーネントや公開ブラウズエンドポイントは軽量で人間向けの埋め込みを目的としていますが、パートナーAPIは大規模な検索、価格設定、予約を行うシステム向けに構築されています。アクセスは統合者ごとに認証され、使用量に応じて課金されるため、実際に送信したトラフィック分だけ支払います。
プランと料金
Section titled “プランと料金”使用量はホテル宿泊数で計測されます：1泊分の宿泊料金が付いた1つのホテルが1ユニットです。1回のリクエストで20軒のホテルを3泊分検索した場合、60ホテル宿泊数となります。コンテンツおよびルックアップ（目的地検索とオートコンプリート）呼び出しは例外で、返される内容に関わらず1回の呼び出しにつき1ユニットです。アカウントエンドポイントは無料です。料金が料金の正確な情報源です。
| 無料 | 有料 | エンタープライズ | |
|---|---|---|---|
| 価格 | $0 | 使用量に基づく | お問い合わせください |
| 最適用途 | 評価および低ボリューム統合 | 大規模な従量課金スループット | カスタムボリューム＆交渉条件 |
| 月間ユニット数 | 10,000 | 無制限 | 無制限 |
| API応答時間（P95） | — | 500ms未満 | 500ms未満 |
| ユニットあたり価格（ホテル宿泊数） | 無料 | $0.0001 | カスタム |
| 月間許容量到達時の応答 | 翌月1日（UTC）まで429 | 課金、ブロックなし | 合意による |
| サービスレベルアグリーメント | — | ✓ | ✓ |
| 優先サポート | — | ✓ | ✓ |
| 専用オンボーディング | — | — | ✓ |
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分あたりの制限はありません。 Winkはリクエストレートを監視し、サービス保護のためにフェアユース制限を適用する場合があります。**HTTP 429（リクエスト過多）**を受け取った場合は、
Retry-Afterヘッダーに示された秒数だけ待ってから再試行してください。 - 月間許容量 — カレンダー月あたり10,000ユニット。 許容量はアカウントごとに付与され、毎月1日（UTC）にリセットされます。許容量に達すると、従量課金に登録していないアカウントは翌月1日までHTTP 429が返されます。これはハードストップで、
Retry-Afterヘッダーと有料プランへの加入を促すメッセージが含まれます。登録済みアカウントは引き続き動作し、許容量超過分は課金されます。
無料プランにはサービスレベルアグリーメントや優先サポートは含まれません。
有料プランは月間上限を撤廃し、使用した分だけ課金されます。
- 従量課金のホテル宿泊数 — 1ホテル宿泊数あたり$0.0001。 月間上限はなく、実際の使用量に基づいて課金されます。Winkはサービス保護のためにフェアユース制限を適用する場合があります。検索および在庫呼び出しは価格付けされたホテル宿泊数ごとに課金され、コンテンツおよびルックアップ呼び出しは1回につき1ユニット課金されるため、リクエストをまとめることで請求額を抑えられます。
有料プランには以下のサービスレベルアグリーメントが含まれます：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は、あなたが割り当てた重大度に基づき、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サブスクリプションの終了または満了により自動的に終了します。終了後も存続すべき性質の条項（未請求のサービスクレジット資格、責任制限、定義など）は存続します。