🌐
统一 API 网关
一个 app_key 跨服务调用,配额/速率/审计统一
所有云集栈产品(UM/IF/MF/Pay/Up/Studio)共用同一 app_key 鉴权。网关统一处理限流、配额扣减、调用审计、CORS。开发者一次接入,全系通行。
example.http
# 同一 access_token 调用不同服务
# 1. 调用 AI 服务(modelflow)
POST https://mf.yunjii.cn/v1/chat/completions
Authorization: Bearer <access_token>
Content-Type: application/json
{ "model": "gpt-4", "messages": [{"role":"user","content":"hi"}] }
# 2. 调用支付服务
POST https://pay.yunjii.cn/api/v1/pay
Authorization: Bearer <access_token>
{ "amount": 9900, "order_id": "order_xxx" }
# 3. 调用存储服务
POST https://up.yunjii.cn/api/v1/upload
Authorization: Bearer <access_token>
Content-Type: multipart/form-data核心能力
6 项核心能力,每项独立可用
一次接入全系通行
一个 app_key 跨 um / if / mf / pay / up / studio 全部服务
统一限流
按 app_key 维度令牌桶,超限 429 + Retry-After
配额扣减
调用自动扣 quota,UM 统一计费,IF/MF 透传扣减
调用审计
每次调用记录日志(app/user/IP/耗时/状态码)
CORS 跨域
按档位配置 allow-origin,free=*, enterprise=白名单
错误统一
{error, error_code, message} 三字段错误体,跨服务一致
API 端点
通过 /api/* 调用以下端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/quota | 查询当前 app_key 配额 |
| GET | /api/v1/usage | 查询调用统计 |
| POST | /api/v1/apps | 创建/管理应用 |