用途:从外部或应用内调用 Bitrix24 REST,适用于云端;本地部署需 main 23.0+。资料标注验证版本 rest 26.650.0(main 26.800.0)、b24restdocs 2026-09-30。
主要能力:规则文件按主题给出调用要点,包括 rules/auth.md(webhook、本地应用、Marketplace OAuth 的区别,令牌刷新与 scope)、rules/calls.md(URL 与请求体格式、列表、快速分页、batch)、rules/limits-errors.md(限制、错误码、重试与退避)、rules/events-placements.md(事件、出站 webhook、离线事件、嵌入位置)、rules/rest-v3.md(REST 3.0 /rest/api/、Idempotency-Key、OpenAPI)、rules/sdk.md(b24phpsdk、b24jssdk、BX24.js、CRest)、rules/on-premise.md(本地部署细节)。
使用方式:调用前先查证方法与字段,可通过 bitrix24-ai-tools 的 MCP 或目标门户的 method.get 查询,不要猜测方法、字段或过滤条件。凭据(webhook URL、client_secret、token、application_token)放在环境变量或密钥库,不进入 VCS、浏览器代码、日志或共享链接。按场景申请最小 scope;调用同时受调用用户权限约束。
限制与注意:错误按 error key 判断(batch 中看 result.result_error),不要依赖 HTTP 状态码。所有入站调用(事件、嵌入、安装)在 auth.application_token 与 member_id 对应存储值匹配前均视为不可信。仅使用 HTTPS。处理程序应快速应答、将工作入队并幂等处理。未提供具体价格、平台限制或更多示例。