获取服务开通信息
功能介绍
该接口用于获取服务开通信息。
接口约束
目前"华北-北京一"和"华东-上海二"区域不支持新用户开通。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/subscription
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
普通租户的token。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 |
|
X-Project-Id |
否 |
String |
使用AK/SK方式认证时必选,携带项目ID信息。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
user_id |
String |
用户ID。 |
|
sip_ip |
String |
SIP服务器地址,VIS对外提供的设备注册地址。 |
|
sip_port |
String |
SIP服务器端口,VIS对外提供的设备注册端口,固定为5080。 |
|
quota |
quotaInfo object |
开通服务返回的quota体。 |
|
created_at |
String |
创建时间,格式为:YYYY-MM-DDTHH:MM:SSZ(UTC时间)。 |
|
is_subscribed |
Boolean |
用户是否开通服务。
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
password |
PassWordInfo object |
GB/T28181凭证配额信息。 |
|
consecutive_access_time |
Consecutive_Access_TimeInfo object |
GB/T28181设备连续接入时长的配额信息。 |
|
random_access_time |
Random_Access_TimeInfo object |
GB/T28181设备随机接入时长的配额信息。 |
|
stream |
StreamInfo object |
视频流配额信息。 |
|
active_stream |
Active_StreamInfo object |
激活视频流配额信息。 |
|
device |
DeviceInfo object |
设备配额信息。 |
|
aksk |
AKSKInfo object |
AKSK凭证配额信息。 |
|
http_num |
HttpInfo object |
http_flv配额信息。 |
|
http_active_num |
HttpActiveInfo object |
http_flv激活配额信息。 |
|
rtmp_num |
RtmpInfo object |
rtmp配额信息。 |
请求示例
GET /v1/3266392d188c47d09948b1**********/subscription
响应示例
状态码: 200
正常
{
"user_id" : "******6045184a8194e021113e******",
"sip_ip" : "10.95.144.***",
"sip_port" : "5080",
"quota" : {
"consecutive_access_time" : {
"total" : 120,
"used" : 120
},
"password" : {
"total" : 10,
"used" : 2
},
"random_access_time" : {
"total" : 240,
"used" : 240
},
"stream" : {
"total" : 500,
"used" : 8
},
"active_stream" : {
"total" : 200,
"used" : 4
},
"device" : {
"total" : 500,
"used" : 0
},
"aksk" : {
"total" : 10,
"used" : 6
},
"http_num" : {
"total" : 10,
"used" : 5
},
"http_active_num" : {
"total" : 5,
"used" : 1
},
"rtmp_num" : {
"total" : 0,
"used" : 0
}
},
"created_at" : "2018-10-25T03:06:10Z",
"is_subscribed" : true
}
状态码: 404
找不到资源或没有开通服务。具体返回错误码请参考错误码说明。
{
"error_msg" : "Failed to find the user subscription info.",
"error_code" : "VIS.0015"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
正常。 |
|
404 |
找不到资源或没有开通服务。具体返回错误码请参考错误码说明。 |