全部产品
云市场

物联网卡卡明细(QueryCardInfo)---PHP

更新时间:2019-07-23 09:11:42

物联网卡卡明细信息

步骤 1 创建阿里云账号

为了访问服务,您需要有一个阿里云账号。如果没有,可首先按照如下步骤创建阿里云账号:

  1. 访问阿里云 官方网站,单击页面上的 免费注册 按钮。
  2. 按照屏幕提示完成注册流程并进行实名认证,该服务只支持实名认证用户使用。为了更好地使用阿里云服务,建议尽快完成实名认证,否则部分阿里云服务将无法使用。具体实名认证流程,请参考 这里

步骤 2 获取阿里云访问密钥

为了使用物联卡 SDK,您必须申请阿里云的访问密钥。。

阿里云访问秘钥是阿里云为用户使用 API(非控制台)来访问其云资源设计的“安全口令”。您可以用它来签名 API 请求内容以通过服务端的安全验证。

该访问秘钥成对(AccessKeyId 与 AccessKeySecret)生成和使用。每个阿里云用户可以创建多对访问秘钥,且可随时启用(Active)、禁用(Inactive)或者删除已经生成的访问秘钥对。

您可以通过阿里云控制台的 秘钥管理页面 创建、管理所有的访问秘钥对,且保证它处于“启用”状态。由于访问秘钥是阿里云对 API 请求进行安全验证的关键因子,请妥善保管你的访问秘钥。如果某些秘钥对出现泄漏风险,建议及时删除该秘钥对并生成新的替代秘钥对。

步骤 3 在控制台完成购卡行为后,且卡被用户正常激活后,获得调用接口必备的参数

ICCID

请到阿里云控制台下的物联网无线服务下的卡管理页面,获取已经正常激活的卡对应的iccid值

参数
请求参数
名称 类型 是否必须 描述
Iccid String 必须 需要查询的物联卡对应的Iccid编码

其他请求参数请参见 公共请求参数

出参列表
出参名称 出参类型 样例取值 参数说明
RequestId String 8906582E-6722 请求ID
Code String OK 状态码-返回OK代表请求成功,其他错误码详见错误码列表
Message String 请求成功 状态码的描述
CardInfo Object - 请参考下面的CardInfo样例
CardInfo样例
出参名称 出参类型 样例取值 参数说明
Iccid String 89860617030017300390 ICCID编号
OpenTime String 20171011000000 开户时间
FirstActiveTime String 20171106174912 激活时间
Msisdn String 1064633113571 MSISDN编码
GprsStatus String GPRS开关状态
VoiceStatus String 语音功能开关状态(暂时未开放,结果列表无此字段)
SmsStatus String 短信功能开关状态(暂时未开放,结果列表无此字段)

公共返回参数,详见 公共请求参数

技术对接步骤

1:下载SDK工具包

SDK&DEMO[下载地址]

2: 编写样例程序

注:有备注无需修改的位置请勿改动。

  1. // 代码节选,详见aliyun-dyiot-php-sdk/api_demo/IotDemo.php
  2. ...
  3. class IotDemo
  4. {
  5. ...
  6. /**
  7. * 物联网卡卡明细
  8. *
  9. * @return stdClass
  10. * @throws ClientException
  11. */
  12. public static function queryCardInfo() {
  13. $request = new QueryCardInfoRequest();
  14. //填入你要查询的iccid值
  15. $request->setIccid('yourIccid');
  16. //hint 此处可能会抛出异常,注意catch
  17. $response = static::getAcsClient()->getAcsResponse($request);
  18. return $response;
  19. }
  20. }

返回示例

JSON示例

  1. {
  2. /* 请求标签,用于追踪错误 */
  3. "RequestId": "7E31A459-E9B1-4A94-8EA0-A4C0E42BAF11",
  4. /* 请求codeOK代表正常 */
  5. "Code": "OK",
  6. /* 异常描述 */
  7. "Message": "ServiceUnavailable",
  8. "CardInfo": {
  9. /* ICCID编号 */
  10. "Iccid": "89860617030017300390",
  11. /* 用户开户时间 */
  12. "OpenTime": "20171011000000",
  13. /* 用户激活时间 */
  14. "FirstActiveTime": "20171106174912",
  15. /* Msisdn 编号 */
  16. "Msisdn": "1064633113571",
  17. /* GPRS开关状态 */
  18. "GprsStatus": "开"
  19. /* 语音开关状态(暂时未开放,结果列表无此字段) */
  20. "VoiceStatus": "开",
  21. /* 短信开关状态 (暂时未开放,结果列表无此字段) */
  22. "SmsStatus": "开"
  23. }
  24. }

错误码

错误代码 描述 Http状态码 语义
isv.RES_OWNER_ID_UNKNOWN Can’t found of the card owner. 400 卡资源归属无效
isv.PRODUCT_UN_SUBSCRIPT The Product need to order,before invoke the API. 400 未开通物联卡产品
isv.IOT_RES_NOT_EXIST Can’t found the card by the iccid number. 400 IccId对应的卡资源不存在
isv.QUERY_ASSETS_ERROR Query user infomation of the card response is error. 400 卡对应的用户资料异常
isv.RAM_PERMISSION_DENY The invoker is permission invoke the API for the card. 400 当前调用者无权对该卡发起请求
isv.INVALID_PARAMETERS The parameters is invalid. 400 请求参数无效,q请核查对应的入参信息
isv.SYSTEM_ERROR System error. 404 系统异常