完整 API 集成适合需要“把状态/结果写回系统，并纳入审计与运营闭环”的团队。公开网关已可核验；凭证仍通过正式开通流程发放。
提示能力状态（2026-08-07 核验）
受控开放 https://api.zhenrobot.com 已提供有效 TLS、GET /healthz、公开 OpenAPI 与受鉴权保护的 POST /api/execute。
当前公开状态
可验证的生产 Base URL 为 https://api.zhenrobot.com。公开入口包含 GET /healthz、OpenAPI YAML 与受鉴权保护的 POST /api/execute。
API Key、Webhook 凭证、配额/计费、SLA 与生产权限仍只以正式平台流程或书面契约为准。
先判断是否真的需要 API
| 你的目标 | 当前更合适的路径 |
|---|---|
| 先验证是否有真实咨询需求 | Hosted Inbox |
| 让入口留在自有网站内 | Widget Embed |
| 把结果、状态或事件接回内部系统 | 继续阅读本页并准备接入评估 |
只有当 Hosted Inbox 或 Widget 无法满足系统回写、权限、审计或工作流编排需求时，才应进入 API 评估。
提示常见误区：先读完协议再开发
对多数团队，更高效的顺序是：先上线入口 → 验证真实需求 → 再决定是否升级到 Full API。Full API 的价值在于“系统级回写与治理”，不在于“更早开始写代码”。
推荐阅读
Full API 评估的四个问题
API Readiness Gate
- 公开可核验
现在可以核验
healthz、OpenAPI 与公开文档可用于核对当前网关和契约。
- 受控开放
当前仍受控
凭证、Webhook 注册、配额、计费与 SLA 仍以正式流程或书面契约为准。
- 接入准备
申请前准备
先明确回写事件、权限范围、Webhook 处理和审计/工作流要求。
在获得正式凭证前，不要把公开网关的可达性误解为生产授权，也不要依赖 OpenAPI 之外的 URL 或接口名。
接入辅助服务
卡在接入环节？我们可以协助完成。
¥399 / 站点 / 案例适合厘清回写、权限与最小接入方案的团队；该服务提供接入评估，不替代完整 API 项目实施。
标准交付
- 确认接入路径
- 协助生成或挂载入口
- 一次基础联调与上线前检查
服务边界
- 不包含复杂定制与长期运营
- 不代管私有凭证或生产权限
- 不包含完整 API 项目实施
公开规范资产
| 资料 | 用途 |
|---|---|
| 核心对象 | 理解需求、授权、路由和事件对象 |
| API Reference | 核对字段、响应结构与状态语义 |
| Conformance | 了解可验证的协议边界 |
| 公开 OpenAPI | 核对公开网关当前暴露的请求与响应契约 |
下一步
- 当前只需上线入口：选择 Hosted Inbox 或 Widget Embed。
- 已明确系统集成需求：完成上述准备项后，携带业务场景、回写需求和安全边界申请正式凭证与接入评估。
不要把规范阅读或登记信息误解为生产可用性
公开网关可用不等于已获得生产权限。凭证、配额、结算和服务等级只有在平台正式流程或公开契约明确后，才构成可验证承诺。
推荐阅读