开发者后台
开发者后台用于创建应用、配置认证和 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 和敏感确认清除。按需验证不会自动重放业务操作,见登录与恢复。