切换主题
查询计费项字典
查询平台当前全部计费项的枚举,用于把账单接口返回的 feeItems[].itemCode 映射为可读名称,或在报表中预置计费项列。
GEThttps://dashboard.avavox.com/open/api/v1/bills/fee-items
本接口返回的是字典数据,与租户无关,两种授权范围的 Key 均可调用。
请勿硬编码计费项列表
平台新增计费项时,本接口会自动扩展,账单接口的 feeItems 中也会随之出现新条目。请在程序中动态读取本接口,不要把计费项写死在代码里。
字典是全集,账单按维度返回子集
本接口返回平台的全部计费项。账单接口只返回该维度实际会产生的计费项:账户账单与空间账单返回全部计费项,机器人账单只返回线路、机器人、调试,任务账单只返回线路、机器人。请按账单响应中实际出现的 itemCode 取值,不要假定每个维度都会返回字典中的全部条目。
请求头
Authorization string 必填
- 填写格式:
Authorization: Bearer <App Key> <App Key>为控制台「App Key 管理」页面生成的 Key。- 获取方式详见:《App Key 创建与管理》。
请求参数
无。
响应数据
code int
状态码,200 为成功,其他状态均为失败。
success boolean
是否成功,true 表示成功,false 表示失败。
message string
描述信息。
data object
点击展开字段说明
list array
计费项列表,元素结构:
itemCode:计费项编码itemName:计费项名称
请求示例
shell
curl -X GET --location 'https://dashboard.avavox.com/open/api/v1/bills/fee-items' \
--header 'Authorization: Bearer $Key'响应示例
json
{
"code": 200,
"message": "操作成功",
"success": true,
"data": {
"list": [
{ "itemCode": "LINE", "itemName": "线路" },
{ "itemCode": "ROBOT", "itemName": "机器人" },
{ "itemCode": "SMS", "itemName": "短信" },
{ "itemCode": "VOICE_CLONE", "itemName": "声音克隆" },
{ "itemCode": "CONCURRENCY", "itemName": "并发" },
{ "itemCode": "STORAGE", "itemName": "存储" },
{ "itemCode": "DEBUG", "itemName": "调试" },
{ "itemCode": "ADJUSTMENT", "itemName": "资金调整" }
]
}
}计费口径
各计费项的具体计费规则、单价与充值赠送政策,见产品文档《平台计费与充值规则说明》。