# 開発者向けTicketingHub。

予約ウィジェットの埋め込み、Widget APIでの独自チェックアウトの構築、Supplier APIとWebhookでのシステム連携ができます。すべてのエンドポイントは[開発者向けドキュメント](https://api.ticketinghub.com/api-docs/index.html)にあります。

- [予約ウィジェット](https://www.ticketinghub.com/ja/developers#widget)
- [Widget API](https://www.ticketinghub.com/ja/developers#widget-api)
- [Supplier APIとWebhook](https://www.ticketinghub.com/ja/developers#apis-webhooks)
- [公開までのステップ](https://www.ticketinghub.com/ja/developers#launch)

## 予約ウィジェットをウェブサイトに埋め込む。

ゲストが予約するライブウィジェットです：チケットを追加して試せます。

- **ウィジェットを埋め込む。**短いコードスニペットでサイトに追加し、公開前にテストできます。

- **自社のブランドカラーを使用。**ホスト型のチェックアウトを、あなたのブランドカラーで自社サイトに。

- **決済はTicketingHubで受け付け。**空き状況、決済、予約確認はTicketingHubが管理します。

予約ウィジェットでの[オンライン販売](https://www.ticketinghub.com/ja/product/sell#online)をご覧ください。

[Immersive Gameboxのサイトでウィジェットの実例を見る](https://www.immersivegamebox.com/en-US)

ライブ – 試してみてください

## Widget APIで独自のチェックアウトを構築。

あなたのチェックアウトがAPIから空き状況を取得し、決済後に予約を確定します。

- **空き状況を取得。**ゲストが予約できる日付と時間を取得します。

- **カートを作成。**チケットとゲストの情報を注文に追加します。

- **認証情報はサーバーに。**リクエストはあなたのサーバーを経由し、注文を確定する前に連携側で決済を行います。

[Widget APIリファレンス](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Widget%20API%20V1)をご覧ください。

*イラスト: 自社のチェックアウトがAPIから空き状況を取得し、ゲストが時間を選ぶと、APIを通じて予約が確定します。*

## Supplier APIとWebhookでシステムを連携。

新しい予約はあなたのツールに送られ、あなたのシステムには署名付きWebhookとして届きます。

- **アカウントを操作。**Supplier APIで、商品、予約、運用を自社のシステムから管理できます。

- **署名付きWebhookを受信。**予約が確定、キャンセル、更新されると通知が届きます。

- **検証と再送。**各署名はサーバーで検証してください。ペイロードと再送についてはドキュメントで説明しています。

[Supplier APIリファレンス](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Supplier%20API%20V2)と[Webhook](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Webhooks)をご覧ください。

*イラスト: 新しいオンライン予約が、連携した各ツールに順番に送られます。*

## 最初のリクエストから公開まで。

1. **何を作るか教えてください。**予約フロー、連携したいシステム、必要なデータを共有してください。

2. **アクセスを確認。**連携に必要なAPIアクセスと設定を、私たちのチームと確認します。

3. **構築してテスト。**APIリファレンスでエンドポイントを確認し、リクエスト形式をチェックして、予約フローをテストします。

4. **公開の準備。**決済処理、エラーレスポンス、連携で使うWebhookを確認します。

## よくある質問。

### 公開のセルフサービスAPIキーを提供していますか？

私たちは、適切なサーフェスと環境を指し示すために、あなたのユースケースについての短い会話の後にAPIアクセスを有効にします。デモを予約して始めましょう。

### Widget APIとSupplier APIの違いは何ですか？

ウィジェットAPIは、埋め込み可能なチェックアウトを中心にサーバー駆動のフローを構築するのに役立ちます。サプライヤーAPIは、製品、予約、運用をプログラムで管理するためのものです。多くのチームが両方を使用しています。

### 本番前にどのようにテストしますか？

私たちは、環境に適した資格情報とドキュメントを提供し、安全に統合を検証できるようにします。TicketingHubの担当者が、構築中に使用するエンドポイントを確認します。

### Webhook はどのように認証されますか？

WebhookはHTTPS経由で配信され、サーバーで検証すべき署名が含まれています。署名シークレットは他の資格情報と同様に扱い、サーバー側にのみ保存してください。

### 実装のサポートを受けられますか？

はい。私たちのチームは、オンボーディング、特殊なケース、そして本番稼働レビューを通じてパートナーをサポートします。特に、支払い、アクセス制御、カスタムレポートを接続する際に役立ちます。