物联网卡设备信息提交

步骤 1 创建阿里云账号

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

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

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

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

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

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

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

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

IMEI

请从设备上摘录设备IMEI编码

参数

请求参数

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

出参列表

IsPostSuccess样例

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

技术对接步骤

1:下载SDK工具包

SDK&DEMO[下载地址]

2: 编写样例程序

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

  

   
 // 代码节选，详见dyiot_php.zip\aliyun-dyiot-php-sdk\api_demo
   
 /**
   
 * 物联网卡设备信息提交
   
 *
   
 * @return stdClass
   
 * @throws ClientException
   
 */
   
 public static function doIotPostImei() {
   
 $request = new DoIotPostImeiRequest();
   

   
 //必填: 需要上传设备的IMEI
   
 $request->setImei('1234567890123456890');
   
 //可选: 设备类型
   
 $request->setDeviceType('device type');
   
 //可选: 备注
   
 $request->setComments('comment');
   

   
 //hint 此处可能会抛出异常，注意catch
   
 $response = static::getAcsClient()->getAcsResponse($request);
   

   
 return $response;
   
 }
  

返回示例

JSON示例

  

   
{
   
 /* 请求标签，用于追踪错误 */
   
 "RequestId": "1C63F16F-D376-4065-816E-3E56CDD13FEB",
   
 /* 请求code，OK代表正常 */
   
 "Code": "OK",
   
 /* 异常描述 */
   
 "Message": "ServiceUnavailable"
   
 "IotPostImei": {
   
 "IsPostSuccess": true
   
 }
   
}
  

错误码