当前租户与账户信息
查询当前鉴权身份所属租户及账户概况,适合检查租户身份、合同与资源使用情况。不能通过本接口选择任意其他租户。
请求
GET /openapi/paas/v1/tenant/get
使用平台 API Key:Authorization: Bearer tk-...。无 Path、Query 或 Body 参数。与 渠道租户查询 不同,不接收 name 参数。
curl "${BASE_URL}/openapi/paas/v1/tenant/get" \
--header "Authorization: Bearer ${AIS_API_KEY}"
响应字段
外层为 普通响应,下表字段位于 data。
| 字段 | JSON 类型 | 说明 |
|---|---|---|
id | integer | /主/键/i/d/ |
code | string | /租/户/编/码/ |
name | string | /账/号/名/称/ |
contact | string | /联/系/人/ |
phone | string | /电/话/手/机/号/ |
startTime | string | /合/同/开/始/时/间/;/旧/日/期/序/列/化/口/径/与/部/署/方/确/认/ |
endTime | string | /合/同/截/止/时/间/;/旧/日/期/序/列/化/口/径/与/部/署/方/确/认/ |
createTime | string | /租/户/创/建/时/间/;/序/列/化/口/径/与/部/署/方/确/认/ |
contactTitle | string | /联/系/人/职/位/ |
email | string | /联/系/邮/箱/ |
company | string | /公/司/名/称/ |
remark | string | /备/注/ |
priceLevel | string | /租/户/价/格/等/级/ |
tokenAmount | number | /账/户/资/源/总/金/额/,/元/;/以/实/际/套/餐/和/充/值/结/果/为/准/ |
useTokenAmount | number | /已/使/用/金/额/,/元/ |
useTokenNumber | integer | /已/消/耗/ /T/o/k/e/n/ /数/量/ |
storage | integer | /总/存/储/,/字/节/ |
useStorage | integer | /已/使/用/存/储/,/字/节/ |
app | object | /应/用/上/下/文/对/象/,/可/为/ /n/u/l/l/;/平/台/ /A/P/I/ /K/e/y/ /调/用/时/可/能/为/空/ |
非空的 data.app 字段:
| 字段 | JSON 类型 | 说明 |
|---|---|---|
app.appid | string | /创/建/的/T/o/k/e/n/,/前/置/ |
app.secret | string | /创/建/的/T/o/k/e/n/,/前/置/ |
app.accessToken | string | /创/建/的/T/o/k/e/n/,/前/置/ |
app.category | string | /应/用/类/型/,/默/认/类/别/,/参/考/{/@/l/i/n/k/ /A/p/p/T/y/p/e/s/}/ |
响应示例
以下日期采用日期时间字符串示意,目标部署对旧日期字段的格式以实际交付配置为准。
{
"code": 8200,
"message": "SUCCESS",
"data": {
"id": 101,
"code": "partner_tenant_001",
"name": "合作客户",
"contact": "示例联系人",
"phone": null,
"startTime": "2026-09-05T00:00:00",
"endTime": "2027-09-05T00:00:00",
"createTime": "2026-09-05T10:30:00",
"contactTitle": null,
"email": null,
"company": "示例公司",
"remark": null,
"priceLevel": "CUSTOM",
"tokenAmount": 1000,
"useTokenAmount": 10.5,
"useTokenNumber": 12000,
"storage": 536870912,
"useStorage": 102400,
"app": null
}
}
接入注意事项
金额与存储字段是账户使用信息,不是请求实时预扣凭据;不要仅凭一次查询承诺后续请求一定可用。该响应可能包含应用凭据和联系资料,只在可信服务端按需使用,不直接透传到公开页面。认证或账户异常按 错误处理 排查。