接入前，准备好应用
- 01
确认开发者身份
登录或注册开发者账号，并确认组织内的开发者权限。第三方企业应用须先完成企业资质认证，通过后才能创建和开发应用。
- 02
创建对应应用
按集成需求选择应用类型。应用是调用接口的身份载体，不同应用的权限和凭证应分别管理。
- 03
配置接口权限
在应用详情的权限管理中添加所需接口权限。文档明确：未添加权限的接口无法调用。
凭证与调用流程
创建应用→配置权限→获取访问凭证→调用业务接口
由应用服务端管理凭证，并根据正式接口文档处理凭证有效期与失败响应。不要把应用密钥写入网页源码、浏览器存储或公开示例。
接口能力目录
以下目录来自现有开发者文档，用于选择需要进一步确认的接口。实际可调用范围取决于应用权限。
| 分类 | 文档列出的能力 | 接入时关注 |
|---|---|---|
| 登录 | 应用免登 | 身份关联、有效期与退出行为 |
| 用户 | 用户信息、当前所选团队、用户下的租户 | 用户身份与租户范围 |
| 团队 | 部门列表、部门用户、角色、角色分组、租户用户 | 组织权限与数据范围 |
| 应用 | 应用依赖信息 | 应用身份与依赖关系 |
联调时怎样排查
请求被拒绝
核对应用是否启用所需接口权限，访问凭证是否有效，以及用户和租户是否在授权范围内。按接口返回的错误信息处理，不要仅依据 HTTP 200 判断业务成功。
结果与预期不一致
核对调用环境、输入参数、用户和团队上下文。记录请求时间、脱敏参数、响应错误码与请求标识，便于定位。
正式资料与技术支持
此页面依据扇子跨境开发者文档及 API 调用指南整理，不提供未经核实的请求示例。真实调用前请查看具体接口约定。
需要进一步帮助？联系扇子跨境 →