携号转网号码查询

描述

查询提交手机号码中是否存在携号转网号码

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

公共参数列表 详情

名称	类型	必须	长度限制	参数格式	备注
Action	String	是	确定值	a-zA-Z+ 操作接口名，系统规定参数，取值：SwitchNumber
Version	String	是	确定值	版本号，系统规定参数，取值：2019-05-01
Mobile	String	是		国内手机号: 11位数字，例如 1xxxxxxxxxx	只支持国内手机号，多个手机号码使用英文逗号(,)连接，单次提交最多支持200个手机号码

返回结果

通过指定 Accept:application/json，返回的数据格式为json

名称	类型	描述
data	array	携号转网列表
RequestId	String	请求唯一标识

示例（调用成功）

请求示例

curl -X POST \
 'http://ksmsapi.api.ksyun.com/' \
 -H 'accept: application/json' \
 -H 'content-type: application/x-www-form-urlencoded' \
 -H 'host: ksmsapi.api.ksyun.com' \
 -d 'Mobile=159xxxx,139xxxx&Action=PortabilityNumber&Version=2019-05-01&Signature=xxxx&SignatureVersion=1.0&Timestamp=2019-08-13T17:18:36Z&Service=ksmsapi&Accesskey=xxx'

响应成功返回示例

{
    "data": [
        {
            "original_operator": "电信",
            "current_operator": "联通",
            "mobile": "1xxxxxxxxxx"
        },
        {
            "original_operator": "联通",
            "current_operator": "电信",
            "mobile": "1xxxxxxxxxx"
        }
    ],
    "RequestId": "21ca0d6f-3120-4eb5-b707-6e53e3e85a92"
}

响应失败返回示例

{
    "RequestId": "B6D67E30-B7E2-4225-A53E-C3CC8D2CDB64",
    "Error": {
        "Type": "server",
        "Message": "The Account do not call service",
        "Code": "AccountServiceUnavailable"
    }
}