调用QueryVirtualNumberRelation查询虚拟号码与真实号码绑定关系列表

查询虚拟号码与真实号码绑定后的数据列表，包括绑定真实号的时间，号码创建时间，一个虚拟号下绑定真实号的数量等。

接口说明

QPS 限制

单用户调用频率：200 次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ProdCode	string	否	产品名称。默认取值：dyvms。	dyvms
PageNo	integer	否	当前页码。默认取值为 1。	1
PageSize	integer	否	每页显示的条数。	10
RouteType	integer	否	路由类型。取值： 0：归属地优先。 1：随机。	0
QualificationId	long	否	资质 ID。此参数可不填。	1000000542****
RegionNameCity	string	否	真实号码归属地。您可以在语音服务控制台真实号管理页面，查询号码归属地。	浙江/杭州
SpecId	long	否	号码类型。取值： 1：虚商号码。 2：运营商号码。 3：95 开头的号码。	1
RelatedNum	string	否	真实号码。您可以在语音服务控制台真实号管理页面，获取真实号。	0213144****
PhoneNum	string	否	虚拟号码。您可以在语音服务控制台虚拟号管理页面，获取虚拟号。	05710000****

返回参数

名称	类型	描述	示例值
	object	返回数据。
Code	string	请求状态码。返回 200 代表请求成功。其他错误码，请参见 API 错误码。	200
Data	string	虚拟号和真实号绑定后的关系列表。部分字段含义： relatedNum：真实号码。 virtualNum：虚拟号码。 createTime：号码开通时间。 specName：供应商名称。 pageNo：当前页码。 pagSize：每页显示的条数。 total：总数。 regionNameProvince：号码归属省。 regionNameCity：号码归属城市。 corpName：企业名称。	{ "data": [ { "regionNameProvince": "湖南", "relatedNum": "0734284**", "specName": "联通全国", "createTime": "2021-07-02 16:04:49", "regionNameCity": "衡阳", "corpName": "阿里巴巴通信技术（北京）有限公司", "virtualNum": "05710000**" } ], "pageSize": 20, "total": 1, "pageNo": 1 }
RequestId	string	请求 ID。	8FAD5988-B483-48A4-B251-6E8470A67371

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Data": "{\n  \"data\": [\n    {\n      \"regionNameProvince\": \"湖南\",\n      \"relatedNum\": \"0734284****\",\n      \"specName\": \"联通全国\",\n      \"createTime\": \"2021-07-02 16:04:49\",\n      \"regionNameCity\": \"衡阳\",\n      \"corpName\": \"阿里巴巴通信技术（北京）有限公司\",\n      \"virtualNum\": \"05710000****\"\n    }\n  ],\n  \"pageSize\": 20,\n  \"total\": 1,\n  \"pageNo\": 1\n}",
  "RequestId": "8FAD5988-B483-48A4-B251-6E8470A67371"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameters	The parameter is invalid.	无效参数
400	VirtualNumber.NotOwn	You can only use your own virtual number.	不能使用非自己所属的虚拟号码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2023-07-18	OpenAPI 错误码发生变更	查看变更详情