基础 bm.elife.recharge.mobile.getItemInfo(查询单个话费直充商品)

非必选步骤,查询单个话费充值商品:
1.返回指定面值,手机号所在区域下优先级最高商品,优先级:"市>省>全国,固定面值>任意充"
2.在同样充值金额下,满足客户选择不同商品需求,可选择与 "查询话费直充商品列表"接口分场景使用
3.可放弃此步骤,直接根据手机号码、充值金额直接生成订单(知道商品编号的前提下)。
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://api.bm001.com/api https://api.bm001.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 必须 接入码,获取方式:登录直销商系统(sale.bm001.com),进入“数据中心” > “开发工具”。
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
mobileNoString 必须 18966668888 需要充值的手机号码
rechargeAmountString 必须 100 正整数,例如20、50、100等面值
 请求示例
OpenClient client = new DefaultOpenClient(url, appSecret);
BmRechargeMobileGetItemInfoRequest req = new BmRechargeMobileGetItemInfoRequest();
req.setMobileNo("17362385123");
req.setRechargeAmount("10");
BmRechargeMobileGetItemInfoResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new BmRechargeMobileGetItemInfoRequest;
$req->setMobileNo("17362385123");
$req->setRechargeAmount("10");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
BmRechargeMobileGetItemInfoRequest req = new BmRechargeMobileGetItemInfoRequest();
req.MobileNo = "17362385123";
req.RechargeAmount = "10";
BmRechargeMobileGetItemInfoResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
mobileItem MobileItem 返回话费充值商品
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": [{
      "code": "isv.invalid-paramete:XXXX",
      "message": "参数XXXX无效,格式不对、非法值、越界等"
    }]
  }
 错误码
错误码 错误描述 解决方案
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050902查询商品列表为空!请检查是否有可用商品!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050903匹配最优商品为空!请检查是否有可用商品!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050904 没有可用货源!请检查是否有可用货源!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00051601 号码信息查询失败,请稍后再试!号码信息查询失败,请检查号码是否正确!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050101获取号码归属地失败!号码归属地查询失败,请检查号码!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050102未查询到号码信息!号码查询失败,请检查号码!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050402供货网账号绑定信息有误,请联系客服解决!!请检查供货网帐号绑定关系!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050403由于库存不足或正在维护,该商品状态为备货中,有疑问请与客服联系,谢谢合作!库存不足或商品正在维护!
isv.bm-elife-recharge-mobile-getItemInfo-service-error:00050401查询商品详情失败!商品获取失败,稍后再试!
 FAQ
Q:为什么确认过货源对接正常,库存也正常,查询商品却一直找不到货源
A:查询商品详情,确认是否超过该货源的可购买数量,一般是1元任意充商品有可购买数量限制,例如一个1元任意充充值商品的可购买数量是10-500,即代表该充值商品可以 充10元-500元话费,如果你输入需要充5元,那么这里是查不到可充值商品的。