跳到正文

开发者后台 ​

开发者后台用于创建应用、配置认证和 API 权限、接收事件以及完成接入验收。使用本人账号登录,首次没有企业时自动准备个人空间;创建者自动成为应用所有者。普通成员按当前权限协作,无需先配置业务角色才能开始。

开发配置无需人工审核。正式上线时创建版本并提交审核,审核通过后发布。

进入开发者后台

管理应用 ​

应用中心支持网格和列表视图,可按名称、Slug、环境、状态和类型搜索筛选。选择应用后,通过左侧目录进入对应页面。

应用内保留工作台、商业管理、应用管理、开发接入四个工作区,侧栏只显示当前工作区。创建普通 Sandbox 应用只需名称,代码自动生成;高级项按需展开。

页面主要功能
概览查看当前应用信息和接入进度
凭证与基础信息查看应用标识,获取或轮换应用身份凭据
OAuth/OIDC 配置配置用户身份、回调地址和登录参数
收费与履约按需配置收费方式、套餐和交付方式
API 与权限自助配置 API 权限,获取调用配置和代码模板
事件与 Webhook推荐长连接;按需配置 HTTPS、同步回调及独立测试结果
Sandbox 与上线确认适用测试,准备独立的正式运行配置
版本管理与发布创建版本、提交审核并发布;新草稿不影响已发布版本
应用协作者、应用设置管理协作者、双语资料、所有权与删除
测试环境与人员准备真人成员与 Sandbox 名单
安全设置限制 OAuth 调用来源 IP
服务端日志、质量概览、客户端日志筛选七日记录与完整窗口统计
支持与反馈提交、跟踪并显式转交平台客服

应用中心的 应用开发流程 按创建、开发测试、版本发布提供对应指南。

配置 API 权限 ​

在 API 与权限 中选择 应用身份权限 或 用户身份权限,再选择所需 API 产品和 Scope。点击 开通权限 后,平台自动校验配置并启用权限。每次配置针对一种身份。

产品名称、产品说明和 Scope 说明支持中文、英文。缺少当前语言的说明时,页面使用默认说明并显示提示。Scope、Audience、版本和路径使用产品提供的固定标识。

登录和 Token 由 GoodVision 统一身份服务提供,应用的组织范围和 API 权限由平台统一校验。开发者只需使用控制台展示的 Client、Issuer、Audience、Scope 和 API 地址,不需要接触平台管理接口。

保存后平台自动校验并完成 OAuth Client 和权限配置,成功即启用。接入无需通过管理接口自行注册或修改平台凭证。

选择身份后,可以复制非敏感的环境变量,以及获取服务 Token、调用 API 和用户 PKCE 登录的代码模板。模板使用占位值,不包含有效 Token、Client Secret 或 Webhook Secret。TypeScript/Node.js 项目可安装官方 SDK;其他语言继续使用当前接口说明和代码模板。

获取凭据 ​

应用身份在 self_service / “可自助获取”时,可按页面提示临时查看或轮换 Secret;Secret 默认隐藏,离开页面或切换组织/应用后立即清除。用户身份使用 PKCE,无需 Client Secret,可在 OAuth/OIDC 页编辑允许的应用地址。普通页面、文档、日志和配置导出不会包含 Secret。

查看调用诊断 ​

拥有当前应用日志权限时,在 服务端日志 或 质量概览 查询最近七天内的记录和完整窗口统计,包括调用次数、成功率、错误数和 P95。URL 路径仅显示公开模板;用户 OpenID、方法和固定错误说明可以筛选,旧记录缺失字段保持未知。客户端上报在 客户端日志 单独查看,不代表服务端执行结果。

查询仅包含当前企业和应用的记录。页面不显示请求或响应正文、Header、Token、Secret、Cookie、客户数据或自由文本错误。

相关文档:应用接入流程 · 接入入口与权限 · 管理应用与配置

登录过期后可原页补登录;同人且范围有效时保留普通草稿,临时 Secret 和敏感确认清除。按需验证不会自动重放业务操作,见登录与恢复。

开发者文档。第三方接入不需要内部运营平台权限。