淘宝开放平台

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

阿里通信API

qimen.alibaba.alicom.vtplan.mobilecard.reserve (星海项目-虚拟套餐号卡业务号码预占接口)

星海项目-虚拟套餐号卡业务号码预占接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
reserveId String 必须 xx_121213123 预占流水
reserveDuration String 必须 360 号码预占时长（秒）
phoneNumber String 必须 150xxxx 手机号码
poolId Number 可选 56 号池ID
province String 可选 110000 省份编码
city String 可选 110100 地市编码
isp String 可选 10 运营商编码

响应参数

名称 类型 示例值 描述
isSuccess Boolean true 请求是否成功
retCode String 0000 0000：成功 0001：失败
retMessage String 预占成功 处理结果信息
phoneInfo PhoneInfo 预占号码信息
  • └ phonePrice
  • Number
  • 1
  • 号码定价（单位分）
  • └ planPeriod
  • Number
  • 1
  • 合约周期（单位月）
  • └ minPay
  • Number
  • 1
  • 最低消费（单位分）
  • └ prePay
  • Number
  • 1
  • 预存金额（单位分）
  • └ poolId
  • String
  • 123
  • 号池
  • └ province
  • String
  • 110000
  • 省份编码
  • └ city
  • String
  • 110100
  • 地市编码
  • └ isp
  • String
  • 10
  • 运营商编码
  • └ phoneNumberType
  • String
  • 2
  • 号码类型 1：普通号 2：靓号
  • └ phoneTag
  • String
  • AABB
  • 靓号标签
  • └ phoneNumber
  • String
  • 15xxx
  • 手机号码

请求示例

{"phoneNumber":"150xxxx","reserveId":"xx_121213123","province":"110000","city":"110100","isp":"10","reserveDuration":"360","poolId":56}

响应示例

{
    "isSuccess":true,
    "retCode":"0000",
    "retMessage":"预占成功",
    "phoneInfo":{
        "phonePrice":1,
        "planPeriod":1,
        "minPay":1,
        "prePay":1,
        "poolId":"123",
        "province":"110000",
        "city":"110100",
        "isp":"10",
        "phoneNumberType":"2",
        "phoneTag":"AABB",
        "phoneNumber":"15xxx"
    }
}

验签示例

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

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

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