Overview
TicketWave の上に構築する - 自分のシステムをチケットデータに接続します。
開発者向け概要
このサイトの残りの内容はすべて、ダッシュボードを通じて TicketWave を設定する サーバー所有者とスタッフ 向けに書かれています。このセクションは異なります。
このページは 開発者 向けに書かれています。小さな Web サービスを実行でき、JSON を読み取れ、ターミナルの操作に慣れていることを前提としています。TicketWave を使うだけなら、これらは 一切不要 です。
このセクションは必要ですか？
| You want to… | Where to go |
|---|---|
| チケットカテゴリ、パネル、またはログを設定する | Dashboard Guides |
| チケット履歴や分析を見る | Dashboard Guides |
| チケットが開いたときに Discord 通知を受け取る | Log Channels |
| チケットイベントを 自分の アプリ、CRM、またはデータベースに送る | このセクション |
| Zapier / n8n / Make の自動化をトリガーする | このセクション |
簡単に言うと、送信先が Discord なら Log Channels を使ってください。送信先が 自分のコード なら、webhook を使います。
利用できるもの
Webhooks
チケットイベントを HTTP リクエストとしてリアルタイムで受け取る
Event Reference
すべてのイベントタイプとその正確なペイロード
Example Server
完全に動作する、実行可能な Express レシーバー
Webhooks は プレミアム 機能です。これらのページを読んでいつでも実装できますが、TicketWave がイベントを配信するには、そのサーバーにプレミアムが必要です。
基本ルール
このセクションのすべてに共通するいくつかのルールがあります。
- HTTPS のみ。 プレーンな
http://エンドポイントは拒否されます。 - 公開ホストのみ。 プライベート、ループバック、リンクローカルのアドレスは拒否されるため、開発中に
localhostは使えません — トンネリングの注意 を参照してください。 - 署名を検証する。 すべてのリクエストは署名されています。署名を確認しないと、あなたの URL を知った誰でも偽のチケットをシステムに送れてしまいます。
- 素早く応答する。 本当の処理は、返信した後に行ってください。返信する前ではありません。
次のステップ
- Webhooks（配信、署名、再試行の仕組み）
- Event Reference（すべてのイベントのペイロード）
- Example Server（コピーして、実行して、受信する）
How is this guide?