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

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

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

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
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 ) 我要提问

返回
顶部

阿里通信API

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

用户导航

用户反馈

用户反馈

用户反馈