Skip to main content
本页帮助你完成第一次 API 调用。系统集成统一推荐团队版,通过团队 AK/SK 为 Owner 或虚拟成员签发短期 Token;面向已有 Meoo 用户提供授权服务时使用 OAuth;用户 API Key 仅用于个人测试、临时调试和个人 CLI。 个人授权场景使用 OAuth。团队系统集成使用团队 AK/SK,为已有 Owner 或新建托管成员签发短期 Token,详见团队系统集成指南。用户 API Key 不作为系统集成方案。第三方 OAuth 应用仍需联系客服完成注册和配置。

1. 准备服务地址

联调时将其替换为 Meoo 对接人员提供的环境地址。

2. 选择接入方式

2.1 OAuth:第三方应用代用户访问

联系 Meoo 客服创建第三方应用,并提供应用名称、应用描述、HTTPS 图标地址、回调地址、应用类型和需要的 Scope。Web 应用会获得:
每次授权都生成新的 statecode_verifiercode_challenge
将这些值临时保存在服务端会话中,然后把用户浏览器跳转到:
实际 URL 不包含换行。回调收到 codestate 后,必须先一次性校验并消费 state,再由服务端兑换 Token:
成功后返回 access_tokenrefresh_tokenexpires_inscope 和当前 Client 隔离的 openid

2.2 API Key:仅限个人测试和自己的自动化

用户在 Meoo 设置页创建 API Key,并选择具体 Scope 或“全部权限”。明文只展示一次:
API Key 直接作为 Bearer Token 使用,不需要 OAuth 回调。它适合个人测试、临时调试和个人 CLI,不推荐用于第三方系统集成:

2.3 团队系统集成

如果接入方以一个团队账号承载多个外部用户,不需要为每位用户执行 OAuth。现阶段由接入方提供团队账号、秒悟团队创建测试 AK/SK;获得凭证后,接入方在可信服务端完成:
AK/SK 不直接作为 Bearer Token 使用;完整签名和 curl 示例见团队系统集成指南

3. 发起第一个资源请求

OAuth 和 AK 只在 Bearer 值上不同,业务接口完全一致:
响应示例:
请完整保存并原样使用 url_id、Token 和 next_page_token,不要尝试解析其结构。

4. 下一步

  • 要创建项目、驱动 AI 生成并读取会话历史:申请 project.write agent.run agent.read,从 Agent 接入指南 开始,字段索引见 Agent OpenAPI
  • 要上传自定义 Skill:申请 skill.write,上传成功后只需 agent.run 即可在 Run 中使用,参见 Skills API
  • 要读取 Storage:申请 cloud.storage.read
  • 要发布 Web 项目当前的生成结果:申请 release.write,并为发布请求生成 Idempotency-Key。App 安装包和小程序平台发布暂未通过 OpenAPI 开放。
  • 上线前完成 运行与安全检查