_前序系列文章>>>【涂鸦物联网脚印】API及SDK介绍

咱们系列文章，都会围绕如何实现一款智能“隔空接吻机”的开发。心愿能帮到各异地恋or异国恋的情侣们！

本文咱们会大略解说基于 OpenAPI 进行开发时所波及到的 API 调用办法、标准、示例以及集成 SDK 相干内容。内容会比拟硬核，请各单位留神！

一、开发流程

  1. 注册开发者账号。
  2. 云开发创立云利用我的项目，获取 client_id & secret。

阐明：开发者平台 key 的名称为 accessId & accessKey。

  1. 创立 SDK：在涂鸦 IoT 平台，抉择 App工作台 > App SDK > 获取SDK > 按要求填写参数 > 获取schema（渠道标识）。
  2. 基于 OpenAPI 进行业务开发。
  3. 测试无误后，开发者自行公布。

二、受权流程

每个业务 OpenAPI 都须要进行 token 校验。

阐明：涂鸦 OpenAPI 遵循 OAuth 2.0 协定规范。

三、简略模式

针对云云对接场景，涂鸦提供了隐式受权的形式获取：

  1. 依照涂鸦云 OpenAPI 接口标准对开发者 client_id 和 secret 进行签名认证。
  2. 涂鸦云校验并颁发令牌给第三方云。

阐明：隐式受权形式获取的 token，权限维度为开发者维度，token 的操作权限范畴为该开发者有权限操作的范畴，例如操作（增、删、改、查）开发者的利用用户数据，产品下的设施数据和利用下用户绑定的设施数据。

四、接口标准

环境阐明

各接口应用方请依据本身所在区域调用相应接口。

中国区 https://openapi.tuyacn.com

美洲区 https://openapi.tuyaus.com

欧洲区 https://openapi.tuyaeu.com

印度区 https://openapi.tuyain.com

申请形式

反对的申请形式如下：

  • GET
  • PUT
  • POST
  • DELETE

阐明：当申请形式为POST时，Content-Type 需应用application/json。

申请头设置

任意接口都须要在 header 中退出如下参数：

阐明：业务接口（非 token 接口）申请时须要参数access_token。

五、签名标准

涂鸦云采纳 HMAC-SHA256 创立摘要，依据不同利用场景，以后提供两套签名算法：

  • 令牌治理接口（获取令牌、刷新令牌）

sign = HMAC-SHA256(client_id + t, secret).toUpperCase()

应用申请到的 client_id 与以后申请的 13 位规范工夫戳拼接成待签名的字符串，采纳申请到的云利用 secret 作为密钥参加哈希摘要，失去的字符串，最初转大写；

  • 业务接口

sign = HMAC-SHA256(client_id + access_token + t, secret).toUpperCase()

应用申请到的云利用 client_id + 以后无效的申请令牌 + 以后申请的 13 位规范工夫戳拼接成待签名的字符串，采纳申请到的云利用 secret 作为密钥参加哈希摘要，失去的字符串，最初转大写。

  • 签名示例
  1. 筹备参数：

client_id：1KAD46OrT9HafiKdsXeg

secret：4OHBOnWOqaEC1mWXOpVL3yV50s0qGSRC

t：1588925778000

access_token：3f4eda2bdec17232f67c0b188af3eec1

  1. 令牌治理接口签名：

待签名字符串：1KAD46OrT9HafiKdsXeg1588925778000

签名后果：HMAC-SHA256(1KAD46OrT9HafiKdsXeg1588925778000,4OHBOnWOqaEC1mWXOpVL3yV50s0qGSRC)

ceaafb5ccdc2f723a9fd3e91d3d2238ee0dd9a6d7c3c365deb50fc2af277aa83

转大写为：CEAAFB5CCDC2F723A9FD3E91D3D2238EE0DD9A6D7C3C365DEB50FC2AF277AA83

3 业务接口：

待签名字符串：1KAD46OrT9HafiKdsXeg3f4eda2bdec17232f67c0b188af3eec11588925778000

签名后果：HMAC-SHA256(1KAD46OrT9HafiKdsXeg3f4eda2bdec17232f67c0b188af3eec11588925778000,4OHBOnWOqaEC1mWXOpVL3yV50s0qGSRC)

36c30e300f226b68add014dd1ef56a81edb7b7a817840485769b9d6c96d0faa1

转大写为：36C30E300F226B68ADD014DD1EF56A81EDB7B7A817840485769B9D6C96D0FAA1

4 各类语言 HMAC SHA256 的实现：

Javascript HMAC SHA256

/**Run the code online with this jsfiddle. Dependent upon an open source js library calledhttp://code.google.com/p/crypto-js/.**/<script src="http://crypto-js.googlecode.com/svn/tags/3.0.2/build/rollups/hmac-sha256.js"></script><script src="http://crypto-js.googlecode.com/svn/tags/3.0.2/build/components/enc-base64-min.js"></script><script> var hash = CryptoJS.HmacSHA256("Message", "secret");  var hashInBase64 = hash.toString().toUpperCase();  document.write(hashInBase64); </script>

PHP HMAC SHA256

/**PHP has built in methods for hash_hmac (PHP 5) and base64_encode (PHP 4, PHP 5) resulting in no outside dependencies. Say what you want about PHP but they have the cleanest code for this example.**/$s = hash_hmac('sha256', 'Message', 'secret', true);echo strtoupper(var_dump($s));

Java HMAC SHA256

/**Dependent on Apache Commons Codec to encode in base64.**/import javax.crypto.Mac;import javax.crypto.spec.SecretKeySpec;import org.apache.commons.codec.binary.Base64;public class ApiSecurityExample {  public static void main(String[] args) {    try {     String secret = "secret";     String message = "Message";     Mac sha256_HMAC = Mac.getInstance("HmacSHA256");     SecretKeySpec secret_key = new SecretKeySpec(secret.getBytes(), "HmacSHA256");     sha256_HMAC.init(secret_key);      byte[] bytes = sha256_HMAC.doFinal(message.getBytes());     String hash = new HexBinaryAdapter().marshal(bytes).toUpperCase();     System.out.println(hash);    }    catch (Exception e){     System.out.println("Error");    }   }}

 C# HMAC SHA256

using System;using System.Security.Cryptography;namespace Test{  public class MyHmac  {    public static string Encrypt(string message, string secret)            {                secret = secret ?? "";                var encoding = new System.Text.UTF8Encoding();                byte[] keyByte = encoding.GetBytes(secret);                byte[] messageBytes = encoding.GetBytes(message);                using (var hmacsha256 = new HMACSHA256(keyByte))                {                    byte[] hashmessage = hmacsha256.ComputeHash(messageBytes);                    StringBuilder builder = new StringBuilder();                    for (int i = 0; i < hashmessage.Length; i++)                    {                        builder.Append(hashmessage[i].ToString("x2"));                    }                    return builder.ToString().ToUpper();                }            }  }}

返回后果 对立返回 JSON，个别格局如下：

申请胜利

{    "success": true,    "result": {        //object    }}

申请异样

{    "success": false,    "code": 1010,    "msg": "token非法"}

六、集成 SDK Java 概述

目前提供的基于Java 的 Tuya Cloud SDK 封装了 token 相干、用户相干以及设施相干的接口，以便减速云云对接的开发。

开发者只须要关注所应用的业务性能办法的调用，构建对应的 TuyaClient 实例，实例会自动更新 token 以及实现对应 API 的调用。SDK 次要包含了以下性能, 具体接口信息请参考后文对应模块：

token 相干（无需用户调用）

用户相干（获取用户列表、注册用户、获取用户下的设施列表）

设施相干（获取设施配网 token、获取配网 token 下所有设施列表等接口）

集成 SDK

IDEA 导入 jar 包： https://jingyan.baidu.com/article/0f5fb0993e9e1f6d8334ead2.html

Eclipse 导入 jar 包： https://jingyan.baidu.com/article/ca41422fc76c4a1eae99ed9f.html

GitHub 地址

https://github.com/TuyaInc/tuya_cloud_sdk_java

通用模块

因为局部新增接口无奈及时同步集成至 SDK，开发者可通过 SDK 通用接口进行程度扩大满足开发。

获取 Header 列表：

/** * 获取Header列表 * @param isToken 是否是token相干申请，个别是false * @return */public List<Header> getHeaders(Boolean isToken)

万能涂鸦接口：

/** * 万能涂鸦接口 * @param url * @param method 申请类型（例如：GET） * @param headers 申请头内容（额定新增的header） * @param body * @return */public String commonHttpRequest(String url, HttpMethod method, Map<String, String> headers, Object body)

调用示例

以下为注册用户的示例：

TuyaClient client = new TuyaClient(clientId, secret, RegionEnum.CN);String uid = client.registerUser("testApp","86","18212345678", MD5Util.getMD5("123456")"nickName",UserTypeEnum.MOBLIE);System.out.println("胜利同步用户: "+ uid);

Golang

Golang SDK 源码地址，请参见Golang SDK。