API 基础知识
YCloud 会根据您的 API Key 解析出租户和 Meta 访问令牌。请勿在这些请求中发送 Meta 访问令牌。
推荐的生命周期
请按顺序遵循“构建与启动”指南。它们将各个 API 资源串联成一个端到端的上线流程。- 准备并检查资格。
- 在受限的测试状态下接入并配置 Agent。
- 测试和评估单轮、多轮及代表性业务场景。
- 从白名单收件人安全逐步推向全部受众。
- 运营已上线的 Agent 并排查故障。
工作流涵盖的资源
每个 API 参考目录都有自己的落地页,并提供指向该领域每个端点的链接。
本版本介绍了 62 个 REST 操作。通过 API 创建的 Agent 还可以发出
回显和转接 Webhook 事件。
归属与隔离
除资格检查外,限定在电话号码范围内的操作都需要由同一 YCloud 租户拥有的处于活动状态的 Public API Agent 绑定。当绑定缺失、属于其他租户或通过不兼容的来源创建时,YCloud 会返回404。这可防止某个租户或集成界面访问另一个 Agent。
