浅易形式接入

概述

涂鸦云平台为创客和厂商供应了自助式软硬件开辟SDK取开放完美的云平台API;

厂商定制的app,发生的用户、装备的数据,归属于厂商,厂商可经由过程API将用户、装备数据像"刷卡"一样简朴随时取走本身的数据。

涂鸦云供应了基于oauth2和谈的如此对接体式格局,开发者可正在涂鸦iot平台申请云API,挪用涂鸦开放的接口,获得客户本身的用户、装备数据,掌握本身有权限的装备等;

厂商可凭据涂鸦供应的client_id, secret署名 挪用/v1.0/token接口到服务端调换token。

client_id申请流程

  • 注册开发者帐号

澳门金沙ag官网

  • 申请开通云API受权

澳门金沙4787.com官网

  • 获得accessId & accessKey(等同于client_id & secret)

云API受权

受权流程

澳门金沙城中心娱乐场

  • (A)开发者运用云API clientId 和 secret 停止署名认证;
  • (B)涂鸦云发表令牌給第三方云。

情况阐明

中国区 https://openapi.tuyacn.com
美洲区 https://openapi.tuyaus.com
欧洲区 https://openapi.tuyaeu.com

各接口运用方请凭据本身所在区域挪用响应接口

恳求体式格局

  • 支撑的恳求体式格局以下:

    • GET
    • PUT
    • POST
    • DELETE

需求注重的是:当恳求体式格局为POST时,Content-Type需运用application/json

返回效果

同一返回json,一样平常花样以下:

业务一般返回:

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

业务毛病返回:

{
"success": false,
"code": 100323,
"msg": "token不法"-澳门金沙ag官网
}

署名体式格局

涂鸦云凭据差别运用场景,当前供应两套署名算法:

  • token获得前署名算法:sign = MD5(client_id + secret + t).toUpperCase()
  • token获得后署名算法:sign = MD5(client_id + access_token + secret + t).toUpperCase()

OAuth2接口阐明

署名(sign)

获得token的署名天生划定规矩以下:

sign = MD5(client_id + secret + t).toUpperCase()

接纳尺度md5算法,天生以后转成大写。

需求注重的是,关于一个恳求URL,其有效期是5分钟。

恳求头设置

获得token的接口需求正在header中到场以下参数:

参数名 范例 参数位置 阐明 必挖
client_id String header client_id
sign String header 接纳token接口署名算法计算出的署名
sign_type String header 署名算法,默许md5,hash
t Long header 13位尺度工夫戳

业务接口阐明

署名(sign)

业务相干接口署名天生划定规矩以下:

sign = MD5(client_id + access_token + secret + t).toUpperCase()

接纳尺度md5算法,天生以后转成大写。

恳求头设置

业务接口皆要正在header中加上以下参数:

参数名 范例 参数位置 阐明 必挖
client_id String header client_id
access_token String header 经由过程上述受权获得的令牌
sign String header 接纳业务接口署名算法计算出的署名
t Long header 13位尺度工夫戳
400-881-8611