本接口用于获取用量统计的地域分布数据。
接口说明
使用说明
本接口用于获取用量统计的地域分布数据。使用该接口时，限制如下：
- 支持查询最近 365 天（不包含查询当天）任意范围的数据。
- 如果查询范围小于 24 小时，则按小时统计查询的数据；如果查询范围大于或等于 24 小时，则按天统计查询的数据。
QPS 限制
本接口的单用户 QPS 限制为 5 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| StartDate | string | 是 | 查询的开始时间，使用 UNIX 时间戳表示，单位：秒。 | 1615824000 |
| EndDate | string | 是 | 查询的结束时间，使用 UNIX 时间戳表示，单位：秒。 | 1615910399 |
| ParentArea | string | 否 | 父级地区名称，例如：杭州市的父级为浙江省，参数设为中国_浙江省。参数为空表示世界范围（国家维度）的统计，例如：中国、英国。 | 中国_浙江省 |
| AppId | string | 是 | APP ID。 | 0rbd**** |
返回参数
示例
正常返回示例
JSON格式
{
"UsageAreaStatList": [
{
"Name": "中国_浙江省",
"AudioCallDuration": 45,
"VideoCallDuration": 4776,
"TotalCallDuration": 4821
}
],
"RequestId": "231470C1-ACFB-4C9F-844F-4CFE1E3804C5"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | ApiParamError | API %s. | Api参数错误 |
| 403 | BizAppError | A business application permission error occurred. | 业务应用权限错误 |
| 403 | BizUidError | A business UID error occurred. | 业务主账号错误 |
| 500 | ServerInternalError | An internal error occurred. | 服务器内部错误 |
访问错误中心查看更多错误码。