マーケットデータ
公開/v1/marketdata/get_world_top
話題の都市、カバープライス、充足率、最近の取引。ATの公開マーキーと同じサーフェス — SSR対応、JSON型、ページネーションあり。
Partner Programs
API統合・公開REST
ATを呼び出す
ATを呼び出す
どこからでも。
すべての予約、入札、取引、会場に対する認証済みRESTインターフェース。AppointmentTraderのウェブアプリと同じエンドポイント。HTTPS、JSON入出力、予測可能なエラー形状。
curl · 任意の言語
JavaScript SDK
Python SDK
PHP SDK
REST · JSON
API key · HMAC
Webhook · signed
仕組み
3ステップ。1つのキー。 最初の通話まで5分。
-
01
APIキーを取得
無料、即時、スコープ付き。公開エンドポイントはキー不要、ユーザースコープはAPIキーとユーザー許可が必要。営業なし、待機リストなし。フォームは /api-documentation.
-
02
/v1/... を呼び出す
HTTPS、JSON入出力、予測可能なエラー形状。AppointmentTraderウェブアプリが使うすべてがここにあり、ドキュメントと例示付き。GraphQLゲートウェイなし、プロトコルの驚きなし。
-
03
AT内にUIが必要？
トラックを切り替え。 アプリ開発パス はATシェルでアプリをラップ — 同じエンドポイントに加えSDK、サイドバーエントリ、ポータルインストール。
エンドポイントファミリー
完全リファレンス
6つのサーフェス。 1つの契約。
入札とオファー
APIキー/v1/concierge/categorize_request
購入意図を提出し、解析済み会場マッチを取得。オープン入札を取得、カウンターを出し、入札を下ろす。アプリ内意図作成と同じ形状。
取引
APIキー/v1/transaction/list
ユーザーごとの認証済み取引履歴。ステータス、日付範囲、場所でフィルタ。状態変化のWebhook購読（支払い済み、転送済み、返金済み）。
ãƒã‚±ãƒ¼ã‚·ãƒ§ãƒ³
公開/v1/location/search
会場検索、オートコンプリート、営業時間、収容人数、写真。AT検索バーと同じデータベース — レストランからDMVスロットまで12カテゴリで索引付け。
通知
APIキー/v1/notification/subscribe
ユーザーごとのプッシュ、メール、SMS購読。トピック別（入札成立、取引確定、メッセージ受信）。標準的なWebhook署名付きで送信。
ユーザー＆ソーシャル
APIキー/v1/user/get_profile
プロフィール、評価、フォローグラフ、アクティビティフィード。公開面は読み取り専用；有効なSDKトークンを持つアプリホストiframe内から呼び出すと完全なCRUD可能。
120+
6つのサーフェスにわたる公開エンドポイント
99.9%
12か月の稼働率、公開＆認証済みサーフェス
<120ms
エッジからのp95レイテンシ、全リージョン対応
$0
無料プラン、クレジットカード不要で開始可能
FAQ
正直な答え。
費用は？
公開サーフェス（市場データ、ロケーション検索）はフェアユースレートで無料。ユーザースコープのエンドポイント（実際のユーザーの予約に関わるもの）は月10,000コールまで無料、その後従量課金。アプリホスト配信（あなたのアプリ内）は /apps/{id}/) is free; we revenue-share only on transactions you originate.
レート制限は？
公開サーフェスは認証なしで60リクエスト/分。APIキー使用で600リクエスト/分。ユーザースコープのエンドポイントはユーザーごとにスライディングウィンドウ制限；制限時はソフトフェイル、継続的な乱用でハードフェイル。すべてのレスポンスに X-RateLimit-Remaining と X-RateLimit-Reset — no surprises.
サンドボックスは？
はい。任意のエンドポイントに ?sandbox=1 を付けるか、同じパスを sandbox.appointmenttrader.com. Same shapes, same auth, fixture data — transactions don't move real money, notifications don't ship to real users, and you can reset the world from the partner dashboard.
Webhookは対応？
はい—HMAC署名付き、バックオフ付きリトライ、ダッシュボードから再生可能。トピックごとに購読（bid.filled, transaction.confirmed, message.received, etc.) with an API key plus a per-user grant. We deliver from a stable IP range you can allowlist; logs and replays live in the partner dashboard for 30 days.
いつApp Developmentに切り替えるべき？
ユーザーがAppointmentTrader内にいる場合。直接API：あなたのアプリ、あなたのサーバー、あなたの配信—ユーザーは設定からAPIキーアクセスを許可し、あなたは /v1/ あなたが所有するバックエンドから呼び出す。 アプリ開発: your app loads inside an iframe on AT, gets a sidebar entry, an SDK token auto-issued for the active user, and ships into the user's portal beside our own surfaces. Same endpoints, same data, different reach — pick by where your users already are.
キーはどうやって取得？
/api-documentation#auth. Sign in to AT, click Generate, copy the key. The first request can land 30 seconds later. There's no review queue for the public tier; user-scoped grants flip on per-app review (typically same-day).
あなたのコード、私たちのマーケットプレイス。 5分で開始。
無料プラン。クレジットカード不要。営業電話なし。AppointmentTraderで見られるすべてを支える同じサーフェス。
120以上の公開エンドポイント。99.9%稼働率。p95は120ms未満。
