# 查询计费项字典

查询平台当前全部计费项的枚举，用于把账单接口返回的 `feeItems[].itemCode` 映射为可读名称，或在报表中预置计费项列。

<span style="display:inline-block;background:#e6f8ea;color:#22a366;border-radius:6px;padding:2px 8px;font-weight:bold;font-family:monospace;margin-right:8px;">GET</span>
`https://dashboard.avavox.com/open/api/v1/bills/fee-items`

本接口返回的是字典数据，与租户无关，两种授权范围的 Key 均可调用。

::: warning 请勿硬编码计费项列表
平台新增计费项时，本接口会自动扩展，账单接口的 `feeItems` 中也会随之出现新条目。请在程序中动态读取本接口，不要把计费项写死在代码里。
:::

::: tip 字典是全集，账单按维度返回子集
本接口返回平台的全部计费项。账单接口只返回该维度实际会产生的计费项：账户账单与空间账单返回全部计费项，[机器人账单](https://avavox.com/docs/developer/bill/robot.html)只返回线路、机器人、调试，[任务账单](https://avavox.com/docs/developer/bill/task.html)只返回线路、机器人。请按账单响应中实际出现的 `itemCode` 取值，不要假定每个维度都会返回字典中的全部条目。
:::

## 请求头

<span style="font-family:monospace; color:#3451b2; ">Authorization </span> <code style="background:#f0f0f0; ">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

- 填写格式：`Authorization: Bearer <App Key>`
- `<App Key>` 为控制台「App Key 管理」页面生成的 Key。
- 获取方式详见：[《App Key 创建与管理》](https://avavox.com/docs/developer/app-key.html)。

## 请求参数

无。

## 响应数据

<span style="font-family:monospace; color:#3451b2;">code</span> <code style="background:#f0f0f0;">int</code>

状态码，200 为成功，其他状态均为失败。

---

<span style="font-family:monospace; color:#3451b2;">success</span> <code style="background:#f0f0f0;">boolean</code>

是否成功，`true` 表示成功，`false` 表示失败。

---

<span style="font-family:monospace; color:#3451b2;">message</span> <code style="background:#f0f0f0;">string</code>

描述信息。

---

<span style="font-family:monospace; color:#3451b2;">data</span> <code style="background:#f0f0f0;">object</code>

<details>
<summary>点击展开字段说明</summary>
<div style="margin: 16px 0; padding: 16px;  border-left: 1px solid #f0f0f0; border-radius: 6px;">

<span style="font-family:monospace; color:#3451b2;">list</span> <code style="background:#f0f0f0;">array</code>

计费项列表，元素结构：

- `itemCode`：计费项编码
- `itemName`：计费项名称

</div>
</details>

## 请求示例

```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": "资金调整" }
    ]
  }
}
```

::: tip 计费口径
各计费项的具体计费规则、单价与充值赠送政策，见产品文档[《平台计费与充值规则说明》](https://avavox.com/docs/billing-rules.html)。
:::