bitrix24-rest-api

Bitrix24 REST API（クライアント側）

ベースライン：Bitrix24 クラウド、オンプレミスの main 23.0 以降 · 検証済み：rest 26.650.0（main 26.800.0）、b24restdocs 2026-09-30

REST の利用。モジュールで独自のメソッドを登録する場合：bitrix-rest。エージェント（MCP）、Vibecode 向けのドキュメント検索：bitrix24-ai-tools。

タスク	参照先
Webhook とローカルアプリ、Marketplace OAuth の比較、トークンの更新、スコープ	rules/auth.md
URL と本文の形式、リスト、高速なページネーション、バッチ	rules/calls.md
制限、エラーコード、再試行とバックオフ	rules/limits-errors.md
イベント、アウトバウンド Webhook、オフラインイベント、プレースメント	rules/events-placements.md
REST 3.0（/rest/api/）、Idempotency-Key、OpenAPI	rules/rest-v3.md
b24phpsdk、b24jssdk、BX24.js、CRest	rules/sdk.md
オンプレミス固有の情報	rules/on-premise.md

不変条件

• メソッド、フィールド、フィルターを推測してはいけません。必ず調べてください（bitrix24-ai-tools の MCP、または対象ポータルの method.get を使用します）。
• Webhook URL、client_secret、トークン、application_token は環境変数またはシークレットストアに保存し、VCS、ブラウザーコード、ログ、共有 URL には保存しないでください。
• 最小権限の原則に従い、シナリオで呼び出すスコープのみを要求してください。呼び出しは、そのユーザーの権限でも実行されます。
• HTTP ステータスではなく、error キー（バッチ内では result.result_error）でエラーを検出してください。
• 受信するすべての呼び出し（イベント、プレースメント、インストール）は、auth.application_token がその member_id に保存されている値と一致するまで、信頼できないものとして扱ってください。
• HTTPS のみを使用してください。ハンドラーは速やかに応答し、処理をキューに入れて、冪等に実行してください。