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。供 Agent（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。
• 遵循最小权限原则：只申请场景所需的权限范围。调用也会使用对应用户的权限。
• 根据 error 键（以及批处理中 result.result_error）检测错误，而不是 HTTP 状态码。
• 在确认 auth.application_token 与为其 member_id 存储的值相符之前，将所有传入调用（事件、嵌入位、安装）视为不可信。
• 仅使用 HTTPS。处理程序应快速确认收到请求，将任务放入队列，并以幂等方式处理。