频道用量与更正
频道用量与原通话分钟独立记录。按实际媒体参与者区间累计毫秒,按统计时区拆分日期,再按应用、日期、媒体合计后向上取整为分钟。发布者和订阅者均计入,准备占位时间不计入;视频频道关闭摄像头仍属于视频分钟。不要套用原通话的“每次每人分别取整”规则。
查询每日用量
/{org_name}/{app_name}/rtc/channel-stats路径参数
应用参数见接入概述。使用 App Token。
查询参数
from、to 必填,格式 YYYY-MM-DD,包含首尾日期,最多 92 天。不能查询未来、起止颠倒或超出最近 180 个统计日保留范围的日期。
请求示例
curl "$IM_API/$ORG/$APP/rtc/channel-stats?from=2026-10-01&to=2026-10-09" -H "Authorization: Bearer $APP_TOKEN"日期需替换为有效范围。
响应
200:timezone 为统计时区;finalized_through 为已定稿水位日期,无水位时 null;items 为每日结果。
| 每日字段 | 类型 | 说明 |
|---|---|---|
date | String | 统计日期 |
status、finalized | String / Boolean | finalized 已定稿、provisional 暂定、pending 尚无汇总 |
audio_participant_ms、video_participant_ms | String / null | 总参与毫秒,十进制字符串,不能转成不安全的 JS number |
audio_estimated_ms、video_estimated_ms | String / null | 总量中属于估计的部分,不能再加一次 |
audio_minutes、video_minutes | Integer / null | 按上述日汇总取整后的分钟 |
version | Integer / null | 日统计版本 |
未定稿缺行返回 pending 与 null,不能解释为用量 0。只有已定稿水位内的缺行才返回零值。迟到事件会推迟定稿,不保证每天某个固定时刻必然定稿。
错误
无效日期或范围为 400 invalid_argument;通用鉴权错误见错误码。
查询用量更正
/{org_name}/{app_name}/rtc/channel-usage-adjustments路径参数
同每日用量接口。
查询参数
cursor、limit 使用通用分页,无写入或人工确认接口。
请求示例
curl "$IM_API/$ORG/$APP/rtc/channel-usage-adjustments?limit=20" -H "Authorization: Bearer $APP_TOKEN"响应
200:items、next_cursor。每项包含:
| 字段 | 说明 |
|---|---|
date、media | 原统计日与 audio / video |
status | pending / confirmed;confirmed 表示计费系统已接收,不代表已出账或结清 |
proposal_version、target_version | 当前提案版本与已确认版本 |
participant_ms、minutes | 已确认的有效用量 |
proposed_participant_ms、proposed_minutes | 当前目标用量,不是要再次全额收费的增量 |
billing_adjustment_id | 计费登记凭证的字符串 ID,未登记为 null |
毫秒字段为字符串,分钟和版本为整数。
错误
无效游标为 400 invalid_argument;其余使用通用错误。
计费规则
对应计量项为 rtc_channel_audio_minutes 与 rtc_channel_video_minutes,是否收费、包含量和单价以套餐为准;既有套餐没有配置新计量项时,不自动按原通话价格收费。
定稿后收到新媒体证明,自动生成版本化更正并按原账期历史套餐、包含量及舍入计算差额。原账期仍为草稿时在生成或重算草稿时纳入;已出账或结清的账单保留,差额结转下一期或更晚可用草稿。已有草稿需要重算才能纳入新登记差额。
减免最多抵到应付为 0,剩余余额继续结转;每张账单调整项上限之外的待入账余额也保留。自动调整不能通过人工删除接口删除。已做过手工补偿的历史期间需业务与平台核对,避免重复补偿。账单规则见套餐与账单。
