Skip to main content

当前租户与账户信息

查询当前鉴权身份所属租户及账户概况,适合检查租户身份、合同与资源使用情况。不能通过本接口选择任意其他租户。

请求

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 类型说明
idinteger/主/键/i/d/
codestring/租/户/编/码/
namestring/账/号/名/称/
contactstring/联/系/人/
phonestring/电/话/手/机/号/
startTimestring/合/同/开/始/时/间/;/旧/日/期/序/列/化/口/径/与/部/署/方/确/认/
endTimestring/合/同/截/止/时/间/;/旧/日/期/序/列/化/口/径/与/部/署/方/确/认/
createTimestring/租/户/创/建/时/间/;/序/列/化/口/径/与/部/署/方/确/认/
contactTitlestring/联/系/人/职/位/
emailstring/联/系/邮/箱/
companystring/公/司/名/称/
remarkstring/备/注/
priceLevelstring/租/户/价/格/等/级/
tokenAmountnumber/账/户/资/源/总/金/额/,/元/;/以/实/际/套/餐/和/充/值/结/果/为/准/
useTokenAmountnumber/已/使/用/金/额/,/元/
useTokenNumberinteger/已/消/耗/ /T/o/k/e/n/ /数/量/
storageinteger/总/存/储/,/字/节/
useStorageinteger/已/使/用/存/储/,/字/节/
appobject/应/用/上/下/文/对/象/,/可/为/ /n/u/l/l/;/平/台/ /A/P/I/ /K/e/y/ /调/用/时/可/能/为/空/

非空的 data.app 字段:

字段JSON 类型说明
app.appidstring/创/建/的/T/o/k/e/n/,/前/置/
app.secretstring/创/建/的/T/o/k/e/n/,/前/置/
app.accessTokenstring/创/建/的/T/o/k/e/n/,/前/置/
app.categorystring/应/用/类/型/,/默/认/类/别/,/参/考/{/@/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
}
}

接入注意事项

金额与存储字段是账户使用信息,不是请求实时预扣凭据;不要仅凭一次查询承诺后续请求一定可用。该响应可能包含应用凭据和联系资料,只在可信服务端按需使用,不直接透传到公开页面。认证或账户异常按 错误处理 排查。