云集接口是统一收口地址。复制下面的 discovery 地址即可拿到授权、令牌、userinfo 的完整端点元信息，无需记忆多域名、无需理解协议细节。
GET https://api.yunjii.cn/.well-known/openid-configuration
/oauth/authorize.php，携带 client_id、redirect_uri、scope 与 code_challenge（S256）。/oauth/token.php 换取 access_token / id_token。/oauth/userinfo.php 获取用户信息，对接完成。| 路径 | 方法 | 说明 | 归属 | 状态 |
|---|---|---|---|---|
/.well-known/openid-configuration | GET | OIDC 发现文档（issuer 指向 UM，因 /oauth 转发 UM） | UM | 已就绪 |
/oauth/authorize.php | GET | 授权端点，302 至 UM 授权页 | UM | 已就绪 |
/oauth/token.php | POST | 换发 access_token / id_token（PKCE S256） | UM | 已就绪 |
/oauth/userinfo.php | GET | 返回用户信息（Bearer） | UM | 已就绪 |
/oauth/revoke.php | POST | 吊销令牌 | UM | 规划中 |
/market | GET | 生态与套餐目录、结算 | open | 规划中 |
/models | GET | 模型推理与网关 | IF / MF | 规划中 |
/cap | GET | 能力声明与发现 | UM | 规划中 |
所有端点使用 Bearer Token；错误统一为 { error, error_description, error_code } 信封，便于跨站统一处理。
{
"error": "invalid_grant",
"error_description": "code 已过期或已使用",
"error_code": 102
}
# 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"