淘宝开放平台

登录
文档中心 > API类目 > 阿里通信API

阿里通信API

qimen.alibaba.alicom.vtplan.mobilecard.select (星海项目-虚拟套餐号卡业务可选号码列表获取)

星海项目-虚拟套餐号卡业务可选号码列表获取

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
isp String 可选 10 运营商编码： 10：中国移动 20：中国联通 30：中国电信
province String 可选 110000 省编码
city String 可选 110100 城市编码
phoneNumberKeyword String 可选 888 含义：号码中包含888关键字
phoneNumberExclude String 可选 44 含义：号码中不包含44关键字
poolList String 可选 123,234 多个号池用英文“,”分隔
phoneNumberType String 可选 1 号码类型： 1：普通号 2：靓号
phoneTag String 可选 AABB 靓号标签
prePayMin String 可选 1 预存金额区间范围中最小值（单位分）
prePayMax String 可选 10 预存金额区间范围中最大值（单位分）
minPayMin String 可选 1 最低消费-区间范围中最小值（单位分）
minPayMax String 可选 10 最低消费-区间范围中最大值（单位分）
planPeriodMin String 可选 1 合约周期-区间范围中最小值（单位月）
planPeriodMax String 可选 12 合约周期-区间范围中最大值（单位月）
phonePriceMin String 可选 1 号码定价-区间范围中最小值（单位分）
phonePriceMax String 可选 10 号码定价-区间范围中最大值（单位分）
maxCount String 可选 20 单次获取号码数量（默认20）
currentPage String 可选 1 当前页
ext String 可选 {"ext":"ext"} 扩展参数信息json
ruleInfo String 可选 [ { "ruleCode": "numberSection", "ruleValue": [ "138", "139" ] }, { "ruleCode": "middleRule", "ruleValue": [ "AAAA", "AAAB" ] } ] 靓号规则信息
sortBy String 可选 phonePrice 排序字段属性： phonePrice：按价格排序 minPay：按低消排序
sortType String 可选 ASC 排序方式（升序/降序）： ASC：升序 DESC：降序

响应参数

名称 类型 示例值 描述
isSuccess Boolean true 请求是否成功
retCode String 0000 0000：成功 0001：失败
retMessage String 查询成功 失败信息
phoneList PhoneList [] 可选号码列表
  • └ phonePrice
  • Number
  • 1
  • 号码定价（单位分）
  • └ planPeriod
  • Number
  • 1
  • 合约周期（单位月）
  • └ minPay
  • Number
  • 1
  • 最低消费（单位分）
  • └ prePay
  • Number
  • 1
  • 预存金额（单位分）
  • └ phoneTag
  • String
  • AABB
  • 靓号标签
  • └ phoneNumberType
  • String
  • 1
  • 号码类型
  • └ isp
  • String
  • 10
  • 运营商编码
  • └ city
  • String
  • 110100
  • 地市编码
  • └ province
  • String
  • 110000
  • 省份编码
  • └ poolId
  • Number
  • 123
  • 号池ID
  • └ phoneNumber
  • String
  • 15xxxxx
  • 手机号码
  • └ phoneNumberDisplay
  • String
  • 135-1234-1234
  • 号码显示值（按特定读法分隔后的显示值，分隔符为"-"）
  • └ highlightPosition
  • String
  • 7,8,9,10
  • 返回高亮位索引列表，逗号分隔多个高亮索引位（索引从0开始） 示例：7,8,9,10 代表索引位7、8、9、10高亮显示，即后四位高亮。
totalCount Number 123 符合条件的号码总数量
currentPage Number 1 当前页（从1开始）
pageSize Number 123 每页数量（入参中的maxCount）

请求示例

{"phonePriceMax":"10","ext":"{\"ext\":\"ext\"}","prePayMax":"10","minPayMin":"1","city":"110100","isp":"10","planPeriodMax":"12","poolList":"123,234","maxCount":"20","minPayMax":"10","prePayMin":"1","province":"110000","sortType":"ASC","phoneNumberExclude":"44","ruleInfo":"[     {         \"ruleCode\": \"numberSection\",         \"ruleValue\": [             \"138\",             \"139\"         ]     },     {         \"ruleCode\": \"middleRule\",         \"ruleValue\": [             \"AAAA\",             \"AAAB\"         ]     } ]","phoneNumberType":"1","planPeriodMin":"1","sortBy":"phonePrice","phoneNumberKeyword":"888","currentPage":"1","phoneTag":"AABB","phonePriceMin":"1"}

响应示例

{
    "isSuccess":true,
    "retCode":"0000",
    "retMessage":"查询成功",
    "phoneList":[
        {
                "phonePrice":1,
                "planPeriod":1,
                "minPay":1,
                "prePay":1,
                "phoneTag":"AABB",
                "phoneNumberType":"1",
                "isp":"10",
                "city":"110100",
                "province":"110000",
                "poolId":123,
                "phoneNumber":"15xxxxx",
                "phoneNumberDisplay":"135-1234-1234",
                "highlightPosition":"7,8,9,10"
        }
    ],
    "totalCount":123,
    "currentPage":1,
    "pageSize":123
}

验签示例

{"retMessage":"Illegal request","retCode":"sign-check-failure","isSuccess":"不等于true"}

错误码解释

错误码 错误描述 解决方案
isp.http-read-timeout
isp.http-connection-refuse
isp.http-connection-timeout
response-body-parse-error
http-service-unknown-error
isp.http-closed

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部