千米开放平台

基础 qianmi.elife.recharge.mobile.getItemInfo（查询单个话费直充商品）

非必选步骤，查询单个话费充值商品：
1.返回指定面值，手机号所在区域下优先级最高商品，优先级："市>省>全国，固定面值>任意充"
2.在同样充值金额下，满足客户选择不同商品需求，可选择与 "查询话费直充商品列表"接口分场景使用
3.可放弃此步骤，直接根据手机号码、充值金额直接生成订单(知道商品编号的前提下)。

用户授权类型

需要授权

公共参数

请求地址:

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.qianmi.com/api	https://api.qianmi.com/api

系统级请求参数:

名称	类型	是否必须	描述
method	String	必须	API接口名称
access_token	String	可选	用户登录授权以后，QMOP颁发给应用的授权信息，详细介绍请点击这里，当前API的用户授权类型标明："需要授权"，则此参数必传，"不需要授权"，则此参数不需要传。
format	String	必须	指定响应格式,目前支持格式为json
appKey	String	必须	分配给应用的AppKey
v	String	必须	API协议版本，当前可选值:1.1
sign	String	必须	API输入参数签名结果
timestamp	String	必须	请求时间戳,时区为GMT+8(北京时间)，格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35"，开放平台允许客户端请求的最大时间误差为10分钟

业务参数

名称	类型	是否必须	示例值	默认值	描述
mobileNo	String	必须	18966668888		需要充值的手机号码
rechargeAmount	String	必须	100		正整数，例如20、50、100等面值

请求示例

OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
RechargeMobileGetItemInfoRequest req = new RechargeMobileGetItemInfoRequest();
req.setMobileNo("13333333333");
req.setRechargeAmount("100");
RechargeMobileGetItemInfoResponse response = client.execute(req, accessToken);

$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new RechargeMobileGetItemInfoRequest;
$req->setMobileNo("13333333333");
$req->setRechargeAmount("100");
$res = $client->execute($req, $accessToken);

IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
RechargeMobileGetItemInfoRequest req = new RechargeMobileGetItemInfoRequest();
req.MobileNo = "13333333333";
req.RechargeAmount = "100";
RechargeMobileGetItemInfoResponse response = client.Execute(req, accessToken);

响应参数

名称	类型	示例值	描述
mobileItem	MobileItem		返回话费充值商品

响应示例

JSON数据格式：

异常示例

JSON数据格式：

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效，格式不对、非法值、越界等"
        }]
  }

错误码

错误码	错误描述	解决方案
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050902	查询商品列表为空！	请检查是否有可用商品！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050903	匹配最优商品为空！	请检查是否有可用商品！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050904	没有可用货源！	请检查是否有可用货源！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00051601	号码信息查询失败，请稍后再试！	号码信息查询失败，请检查号码是否正确！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050101	获取号码归属地失败！	号码归属地查询失败，请检查号码！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050102	未查询到号码信息！	号码查询失败，请检查号码！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050402	供货网账号绑定信息有误，请联系客服解决！！	请检查供货网帐号绑定关系！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050403	由于库存不足或正在维护，该商品状态为备货中，有疑问请与客服联系，谢谢合作！	库存不足或商品正在维护！
isv.qianmi-elife-recharge-mobile-getItemInfo-service-error:00050401	查询商品详情失败！	商品获取失败，稍后再试！

API工具

API TOOLS在线测试工具授权辅助工具错误码查询工具 SDK下载

FAQ

Q:为什么确认过货源对接正常，库存也正常，查询商品却一直找不到货源
A:查询商品详情，确认是否超过该货源的可购买数量，一般是1元任意充商品有可购买数量限制，例如一个1元任意充充值商品的可购买数量是10-500，即代表该充值商品可以充10元-500元话费，如果你输入需要充5元，那么这里是查不到可充值商品的。