统一接口网关 · 一次接入,全家族能力
YUNJII API · 统一接口

云集统一接口,
一个地址接入全家族能力

身份、支付、生态、模型——一次接入,统一鉴权与错误信封。无状态路由,零功能重叠,标准 OAuth 2.1 开箱即用。

discovery · openid-configuration
# 复制这一个地址,即可拿到全部端点元信息
GET https://api.yunjii.cn/.well-known/openid-configuration

# 统一收口地址,所有能力归口于此
/user   · 统一身份(OAuth 2.1 · userinfo · SSO)
/pay    · 统一支付与钱包(余额 · 充值 · 扣减)
/oauth  · 授权 / 令牌 / 吊销(标准协议端点)
/api    · 开发者平台后端(应用 · 策略 · 额度)
1
统一收口地址
17+
已接入家族应用
4
核心能力域
100%
无状态路由
CAPABILITIES

核心能力域 · 已就绪

所有能力以「能力命名」收口于统一网关,底层协议对用户透明。下列端点已全量可用。

/user
统一身份
授权、令牌、userinfo · 跨站通用资料 · 底层 OAuth 2.1
已就绪
/pay
统一支付与钱包
余额 / 积分查询、充值下单、余额扣减、异步回调 · 计费全归 UM
已就绪
/oauth
OAuth 2.1 授权
authorize / token / revoke · PKCE S256 · 标准协议端点
已就绪
/api
开发者后端
应用管理、策略、额度、客户与设备 · 开发者平台收口
已就绪
/.well-known
OIDC 发现
openid-configuration · 自动发现授权/令牌/用户端点元信息
已就绪
/market · /models · /cap
生态 · 模型 · 注册表
能力目录、模型推理、能力发现 · 命名体系已预留,逐步上线
规划中
FAMILY

一个生态,三类角色

云集接口把身份、生态、模型三类主体能力统一收口。一次接入,即可调用全家族能力——无论是人、应用,还是智能体。

身份 · Identity

/user · /oauth
统一身份基座,跨站通用。
  • 统一登录与 OAuth 2.1 授权
  • userinfo 用户信息(Bearer)
  • SSO Cookie · 跨站免登资料
  • 错误信封跨站统一

生态 · Market

/market · /pay
能力目录与计费结算收口。
  • 能力目录与套餐
  • 统一支付与钱包余额
  • 充值 / 扣减 / 异步回调
  • 计费全归 UM,应用零账单

模型 · Models

/models
模型推理与网关(归 IF / MF)。
  • 统一模型推理网关
  • OpenAI 兼容接口
  • Agent-first(MCP / OAuth 2.1)
  • 内建可观测与额度
WHY YUNJII API

为什么选择云集接口

不是又一个应用商店,而是一套能力组合。以统一身份为基座,让接入方一次对接,即可调用全家族能力。

统一身份基座

一个 UM 账号,通行全家族站点与应用,资料与 SSO 一次配置处处可用。

一次接入全家族

只需对接 api.yunjii.cn 一个地址,身份、支付、模型能力按命名域直接调用。

标准 OAuth 2.1

PKCE S256、Bearer 令牌、OIDC 发现文档,符合开放标准,主流 SDK 即接即用。

无状态路由

网关零功能重叠,纯转发收口,延迟低、可水平扩展、故障域隔离清晰。

统一错误信封

所有端点错误统一为 { error, error_description, error_code },跨站一致处理。

Agent-first

面向智能体设计(MCP + OAuth 2.1 + DCR + PRM),自然语言即接口,能力即产品。

QUICKSTART

快速开始

云集接口是统一收口地址。复制下面的 discovery 地址即可拿到授权、令牌、userinfo 的完整端点元信息,无需记忆多域名、无需理解协议细节。

GET https://api.yunjii.cn/.well-known/openid-configuration

OAuth 2.1 授权流程

1
跳转 /oauth/authorize.php,携带 client_idredirect_uriscopecode_challenge(S256)。
2
用户在 UM 授权页完成授权,浏览器带着 code 回调你的 redirect_uri
3
code + code_verifier POST /oauth/token.php 换取 access_token / id_token
4
携带 Bearer 调用 /oauth/userinfo.php 获取用户信息,对接完成。

代码示例 · Code Sample

# 1) 发现端点元信息
curl https://api.yunjii.cn/.well-known/openid-configuration

# 2) 拼接授权 URL(PKCE S256)
https://api.yunjii.cn/oauth/authorize.php
  ?response_type=code&client_id=YOUR_APPID
  &redirect_uri=https://your-app/callback
  &scope=openid profile
  &code_challenge=BASE64URL(SHA256(verifier))
  &code_challenge_method=S256

# 3) 用回调的 code 换 token
curl -X POST https://api.yunjii.cn/oauth/token.php \
  -d grant_type=authorization_code -d client_id=YOUR_APPID \
  -d code=CODE -d redirect_uri=https://your-app/callback \
  -d code_verifier=VERIFIER

# 4) 带 Bearer 取用户
curl https://api.yunjii.cn/oauth/userinfo.php \
  -H "Authorization: Bearer ACCESS_TOKEN"
REFERENCE

端点参考

路径方法说明归属状态
/user/*统一身份能力域(与 /market /models /cap 命名体系一致;底层等价 /oauth/*)UM已就绪
/pay/*统一支付与钱包(wallet / recharge / deduct / order / notify / catalog)UM已就绪
/.well-known/openid-configurationGETOIDC 发现文档(issuer 指向 UM,因 /oauth 转发 UM)UM已就绪
/oauth/authorize.phpGET授权端点,302 至 UM 授权页(协议端点,/user/authorize.php 等价)UM已就绪
/oauth/token.phpPOST换发 access_token / id_token(PKCE S256)UM已就绪
/oauth/userinfo.phpGET返回用户信息(Bearer)UM已就绪
/oauth/revoke.phpPOST吊销令牌UM规划中
/api/*开发者平台后端(应用 / 策略 / 额度 / 客户 / 设备)UM已就绪
/marketGET生态与套餐目录、结算open规划中
/modelsGET模型推理与网关IF / MF规划中
/capGET能力声明与发现UM规划中
SECURITY

统一鉴权与错误信封

所有端点使用 Bearer Token;错误统一为 { error, error_description, error_code } 信封,便于跨站统一处理。

{
  "error": "invalid_grant",
  "error_description": "code 已过期或已使用",
  "error_code": 102
}
RELATED

相关链接

下面是各站的运营与生态入口;接口规范以本页为准。

STATUS

服务状态

所有系统运行正常