Group Account Sub-Account Usage Alert Callback
Updated: 2025-08-18 17:09:34
Interface Description
1、在集团账号2.0后台配置回调地址, 用于接收分账号的用量预警信息(套餐过期, 资源不足...)
Configuration Entry
Callback Request Method
POST application/json
Request Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| company | true | String | Company name |
| true | String | Sub-account email | |
| days | false | String | Number of days. Present for alerts of type day (remaining days). |
| ratio | false | String | Ratio (2 decimal places). Present for alerts of type ratio (resource trial ratio). |
| amount | false | String | Amount. Present for pending payment order reminders. |
| packageName | false | String | Package name. Present for package expiration alerts. |
| minutes | false | String | Package name. Present for package expiration alerts. |
| traffic | false | String | Package name. Present for package expiration alerts. |
| noticeCode | true | String | See noticeCode field description |
| noticeName | true | String | See noticeCode field description |
| noticeType | true | String | See noticeCode field description |
| time | false | String | Expiration time, format: yyyy-MM-dd. Present for package expiration alerts. |
noticeCode Parameter Description
| noticeCode | noticeName | noticeType |
|---|---|---|
| LIVE_PACKAGE_EXPIRED | Live package expired | expire (30,7,3,0 days) |
| LIVE_CDN_MINUTES_INSUFFICIENT | Live CDN minutes insufficient | ratio (30,20,10,5,0%) |
| LIVE_CDN_MINUTES_DAY_INSUFFICIENT | Live CDN minutes days insufficient | day (10,3,1 days) |
| LIVE_MIC_AVAILABLE | Live mic minutes insufficient | ratio (30,20,10,5,0%) |
| LIVE_MIC_DAY | Live mic minutes days insufficient | day (10,3,1 days) |
| LIVE_GUIDE_DAY | Live guide minutes days insufficient | day (10,3,1 days) |
| VOD_PACKAGE_EXPIRED | VOD package expired | expire (30,7,3,0 days) |
| VOD_PACKAGE_INSUFFICIENT | VOD package traffic insufficient | ratio (100,90,80%) |
| VOD_FLOW_UNABLE_USE | VOD traffic insufficient | null (0%) |
| VOD_FLOW_DAY_INSUFFICIENT | VOD traffic days insufficient | day (10,3,1 days) |
| VOD_SPACE_INSUFFICIENT | VOD storage insufficient | ratio (90,0%) |
| FINANCE_DAY_INSUFFICIENT | Balance days insufficient | day (10,3,1 days) |
| FINANCE_AVAILABLE_INSUFFICIENT | Balance insufficient | ratio (30,20,10,5,0%) |
| FINANCE_EXPIRE | Balance expired | expire (30,7,3,0 days) |
| RESOURCE_POINT_DAY_INSUFFICIENT | Resource point days insufficient | day (10,3,1 days) |
| RESOURCE_POINT_AVAILABLE_INSUFFICIENT | Resource points insufficient | ratio (30,20,10,5,0%) |
| RESOURCE_POINT_EXPIRE | Resource points expired | expire (30,7,3,0 days) |
| FINANCE_PENDING_ORDER_REMINDER | Pending payment order reminder | null (1,7,15 days) |
| FINANCE_CREDIT_AVAILABLE_INSUFFICIENT | Credit limit insufficient | ratio (10,0%) |
| LIVE_CHANNEL_INSUFFICIENT | Live channels insufficient | number (50,30,10,0) |
| LIVE_FLOW_DAY_INSUFFICIENT | Live traffic days insufficient | day (10,3,1 days) |
| LIVE_FLOW_AVAILABLE_INSUFFICIENT | Live traffic insufficient | ratio (30,20,10,5,0%) |
| LIVE_PEAK_CONCURRENCE_INSUFFICIENT | Peak concurrency insufficient | ratio (0%) |
| LIVE_PEAK_CONCURRENCE_AVAILABLE | Peak concurrency usage alert | number (0%) |
Example
Live package expiration alert
{
"company": "xxx有限公司",
"email": "xxx@qq.com",
"days": "3",
"ratio": null,
"amount": null,
"packageName": "体验版",
"minutes": null,
"traffic": null,
"time": "2024-12-22",
"noticeCode": "LIVE_PACKAGE_EXPIRED",
"noticeType": "expire",
"noticeName": "直播套餐过期"
}
Live CDN minutes days insufficient
{
"company": "xxx有限公司",
"email": "xxx@qq.com",
"days": "7",
"ratio": null,
"amount": null,
"packageName": "直播分钟数",
"minutes": "14,942",
"traffic": null,
"time": null,
"noticeCode": "LIVE_CDN_MINUTES_DAY_INSUFFICIENT",
"noticeType": "day",
"noticeName": "直播cdn分钟数天数不足"
}
VOD traffic insufficient
{
"company": "xxx有限公司",
"email": "xxx@qq.com",
"days": null,
"ratio": null,
"amount": null,
"packageName": null,
"minutes": null,
"traffic": null,
"time": null,
"noticeCode": "VOD_FLOW_UNABLE_USE",
"noticeType": null,
"noticeName": "点播流量不足"
}
Due to the large number of types, not all are listed. If you need to integrate other types and the parameters are unclear, please contact customer service for consultation.
