阿里云首页 号码百科

DescribePhoneNumberAttribute - 号码归属查询

调用DescribePhoneNumberAttribute接口获取号码当前服务运营商、归属地和携号转网信息。

使用说明

本接口用于获取号码当前服务运营商、归属地和携号转网信息。

QPS限制

本接口的单用户QPS限制为6000次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

授权信息

默认仅限阿里云账号使用本接口,RAM用户只有在被授予了相关API操作权限后方可使用。具体请参见为RAM用户授权

调试

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

调试

授权信息

当前API暂无授权信息透出

请求参数

名称类型必填描述示例值
PhoneNumberstring

要查询的手机号码。

1511234****

返回参数

名称类型描述示例值
object
Codestring

请求状态码。取值:

  • OK:成功。

  • isp.NUMBER_NON_EXISTENT:传入的手机号查不到归属结果。

  • isv.INVALID_PARAMETERS:非法参数。

  • isp.SYSTEM_ERROR:网元系统异常。

  • isp.QPS_LIMIT:触发QPS限制。

OK
Messagestring

状态码的描述。

OK
RequestIdstring

请求ID。

CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47
PhoneNumberAttributeobject

号码归属信息。

BasicCarrierstring

基础运营商。详细说明,请参见下表字段含义。取值:

  • 中国移动

  • 中国联通

  • 中国电信

中国移动
Carrierstring

实际运营商(含虚拟运营商),如果存在携号转网,则为携转后的运营商。详细说明,请参见下表字段含义。

中国移动
IsNumberPortabilityboolean

是否携号转网。

false
NumberSegmentinteger

号段。

1511234
Citystring

号码归属城市。

杭州
Provincestring

号码归属省份。

浙江

BasicCarrier和Carrier字段含义:

手机号段归属是否有携号转网BasicCarrier字段返回结果Carrier字段返回结果
基础运营商号段携转后基础运营商(中国移动、中国联通、中国电信)携转后基础运营商(中国移动、中国联通、中国电信)
基础运营商号段基础运营商(中国移动、中国联通、中国电信)基础运营商(中国移动、中国联通、中国电信)
虚拟运营商号段暂不支持基础运营商(中国移动、中国联通、中国电信)虚拟运营商(如:阿里云通信等)

示例

请求示例

http(s)://dytnsapi.aliyuncs.com/?Action=DescribePhoneNumberAttribute
&PhoneNumber=1511234****
&公共请求参数

正常返回示例

JSON格式

{
    "Code": "OK",
    "Message": "OK",
    "RequestId": "CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47",
    "PhoneNumberAttribute": {
        "BasicCarrier": "中国移动",
        "Carrier": "中国移动",
        "IsNumberPortability": false,
        "NumberSegment": 1511234,
        "City": "杭州",
        "Province": "浙江"
    }
}

XML格式

<DescribePhoneNumberAttributeResponse>
    <Code>OK</Code>
    <Message>OK</Message>
    <RequestId>CC3BB6D2-2FDF-4321-9DCE-B38165CE4C47</RequestId>
    <PhoneNumberAttribute>
        <BasicCarrier>中国移动</BasicCarrier>
        <Carrier>中国移动</Carrier>
        <IsNumberPortability>false</IsNumberPortability>
        <NumberSegment>1511234</NumberSegment>
        <City>杭州</City>
        <Province>浙江</Province>
    </PhoneNumberAttribute>
</DescribePhoneNumberAttributeResponse>

错误码

HttpCode错误码错误信息描述
400InvalidParameterThe specified parameter is invalid.非法参数
400PhoneNumberNotfoundThe queried number is not found.-
400OutOfServiceThe ISV is out of service.业务已停机
400Product.UnsubscriptYou have not subscribed to the specified product.未订阅该功能
400Queries.RepeatedYou can only query phoneNumber once every 60 seconds.60秒内重复查询
400Ram.PermissionDenyYou are not authorized to perform the operation.权限不足
400System.LimitControlThe system is under flow control.系统限流控制
400Unknown.ResourceOwnerIdThe resource does not belong to the current user.资源不属于当前用户
400InvalidParameterThe specified mobile phone number is invalid.非法号码
400Ram.CheckFailedYou did not pass the ARM permission check.RAM权限校验失败
400Product.NotOrderedYou have not ordered this product (offer).未订购该产品
500InternalErrorAn error occurred while processing your request.系统异常

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

变更历史

变更时间变更内容概要操作
2022-01-21新增 OpenAPI
首页 号码百科 API参考指南 API目录 查询 DescribePhoneNumberAttribute - 号码归属查询