调用QueryVirtualNumberRelation查询虚拟号和实体号的关系。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryVirtualNumberRelation

系统规定参数。取值:QueryVirtualNumberRelation

ProdCode String dyvms

产品名称。默认取值:dyvms

PageNo Integer 1

页号。

PageSize Integer 10

分页大小。

RouteType Integer 0

路由类型。取值:

0:归属地优先。

1:随机。

QualificationId Long 123456

资质ID。

RegionNameCity String 杭州市

虚拟号码归属地市。

SpecId Long 1

号码类型。取值:

  • 1:虚商号码,即170或171。
  • 2:运营商号码。
  • 3:95号码。
RelatedNum String 1705559****

真实号码。

PhoneNum String 05516214****

虚拟号码。

返回数据

名称 类型 示例值 描述
Code String 200

请求状态码。

  • 返回200代表请求成功。
  • 其他错误码,请参见API错误码
Data String {"data":[{"relatedNum":"17055593947","createTime":"2021-03-26 12:34:08"}],"pageSize":20,"total":1,"pageNo":1}

虚拟号和实体号的关联列表。字段含义:

  • relatedNum:真实号码。
  • createTime:号码开通时间。
  • pageNo:分页号。
  • pagSize:分页大小。
  • total:总数。
RequestId String 8FAD5988-B483-48A4-B251-6E8470A67371

请求ID。

示例

请求示例

http(s)://dyvmsapi.aliyuncs.com/?Action=QueryVirtualNumberRelation
&<公共请求参数>

正常返回示例

XML格式

<QueryVirtualNumberRelationResponse>
  <RequestId>8FAD5988-B483-48A4-B251-6E8470A67371</RequestId>
  <Data>
        <data>
              <relatedNum>1705559****</relatedNum>
              <createTime>2021-03-26 12:34:08</createTime>
        </data>
        <pageSize>20</pageSize>
        <total>1</total>
        <pageNo>1</pageNo>
  </Data>
  <Code>200</Code>
</QueryVirtualNumberRelationResponse>

JSON格式

{
	"RequestId": "8FAD5988-B483-48A4-B251-6E8470A67371",
	"Data": {
		"data": [
			{
				"relatedNum": "1705559****",
				"createTime": "2021-03-26 12:34:08"
			}
		],
		"pageSize": 20,
		"total": 1,
		"pageNo": 1
	},
	"Code": "200"
}

错误码

HttpCode 错误码 错误信息 描述
400 UnauthorizedOperation You have not been authorized. 未开通权限

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