前言
随着工业自动化的不断发展，云端设备数据开发应用这门技术也越来越重要，很多人都开启了学习云端设备数据开发，本文就介绍了设备入云后的FlexCloud云数据转HTTP开发接口基础操作。
提示：以下是本篇文章正文内容，下面案例可供参考
一、接口地址使用
不同版本的服务器使用不同的接口地址。
1、服务器1.79 以下版本
Id Server:
登录服务器，公有云地址为：https://account.flexem.com，若私有云的话改为对应私有云的配置域名。
App Server:
主应用服务器，公有云地址为：http://fbox360.com，若私有云的话改为对应的私有云配置域名。
Hs Server:
历史记录服务器，公有云地址: http://fbhs1.fbox360.com/api，若私有云的话改为对应的私有云配置域名。
apiBaseUrl:
通讯服务器，公有云地址为：http://fbcs101.fbox360.com/api/，若私有云的话改为对应的私有云配置域名。获取方式：FBox列表获取接口中boxRegs下box下的cs中的apiBaseUrl。
signalRUrl：
signalR服务，公有云地址为：http://fbcs101.fbox360.com/push，若私有云的话改为对应的私有云配置域名。获取方式：FBox列表获取接口中boxRegs下box下的cs中的signalRUrl。
2、服务器1.79 及以上版本
Host Server:
公有云地址为：https://fbox360.com ，若私有云的话改为对应的私有云配置域名。
注： 新的接口地址和旧的接口地址都可以兼容使用，新版的地址也是适用全部的接口文档，所有的接口就使用这一个接口地址。
注意事项:
该文档中接口请求body部分若无特殊说明，请求格式为application/json格式。
该文档中所有接口均不支持跨域请求 。
二、用户登录
FlexCloud云数据共有两种登录方式。
1、方式一
(在Manager平台上创建的开发者账号只能用方式一传参)
接口功能
该接口用于用户获取accessToken。
注意：
获取到的accessToken有效期是大约2小时,调用接口若出现401错误则通过refreshToken调用重新登录接口刷新accessToken，若通过refreshToken获取不到再通过用户名和密码获取，不要访问频繁，若超过一定频率，会屏蔽IP处理。
注意:
该文档中所有接口均不支持跨域请求
请求地址
（二选一）
新版：
URL:[Host Server]/idserver/core/connect/token
旧版：
URL:[Id Server]/core/connect/token
地址参数说明：
参数名类型参数描述Id Serverstring详情见名词解释
Method：POST
Headers：NULL
Body：
参数名类型参数描述scopestringfboxclient_idstring开发者IDclient_secretstring密钥原文grant_typestringclient_credentials
注意事项
登录接口与重新登录接口的Content-Type（body的格式）为application/x-www-form-urlencoded
其他接口body的格式为均为application/json格式。
client_id、client_secret为在Manager平台创建的开发者ID、密钥，详情见开发者创建页面。
scope和grant_type为描述中所述固定值。
返回字段：
参数名类型参数描述access_tokenstringaccessTokenexpires_inintaccessToken的有效期token_typestringaccessToken的类型(Bearer)固定值
返回码：
参数名类型400“error_description”=“invalid_username_or_password”(账号或密码错误)或"error": “invalid_client”(开发者账号或密码错误)404接口不存在，请检查URL429被服务器拒绝（登录过于频繁，客户端被禁止等），详情见429状态码
调用案例
如下图：
2、方式二
向FlexCloud申请的开发者账号只能用方式二方式传参。
接口功能
该接口用于用户获取accessToken。
注意：
获取到的accessToken有效期是2小时,refreshToken有效期为30天，调用接口若出现401错误则通过refreshToken调用重新登录接口刷新accessToken，若通过refreshToken获取不到再通过用户名和密码获取，不要访问频繁，若超过一定频率，会屏蔽IP处理。
注意:
该文档中所有接口均不支持跨域请求
请求地址：
（二选一）
新版：
URL:[Host Server]/idserver/core/connect/token
旧版：
URL:[Id Server]/core/connect/token
参数说明：
参数名类型参数描述Id Serverstring详情见名词解释
Method：POST
Headers：NULL
Body：
参数名类型参数描述scopestringfboxclient_idstring开发者IDclient_secretstring密钥原文grant_typestringclient_credentials
注意事项
登录接口与重新登录接口的Content-Type（body的格式）为application/x-www-form-urlencoded。
其他接口body的格式为均为application/json格式。
username、password为登录FlexManager账号密码。请自行下载FlexManager并注册。
client_id、client_secret为服务器为各种客户端所创建的开发者账号、密码，用于区分各类客户端，请联系与贵公司对接的销售获取。
scope和grant_type为描述中所述固定值。
返回字段：
参数名类型参数描述access_tokenstringaccessTokenexpires_inintaccessToken的有效期refresh_tokenstringaccessToken过期后，刷新accessTokentoken_typestringaccessToken的类型(Bearer)固定值
返回码：
参数名类型400“error_description”=“invalid_username_or_password”(账号或密码错误)或"error": “invalid_client”(开发者账号或密码错误)404接口不存在，请检查URL429被服务器拒绝（登录过于频繁，客户端被禁止等），详情见429状态码
调用案例
如下图:
三、旧版重新登录
接口功能
Token过期，成功登录过且refresh_token有效的情况下优先选择该接口刷新Token
请求地址
（二选一）
旧版：
URL:[Id Server]/core/connect/token
新版：
URL:[Host Server]/idserver/core/connect/token
地址参数说明：
参数名类型参数描述Id Serverstring详情见名词解释
Method：POST
Headers：NULL
Body：
参数名类型参数描述refresh_tokenstring登录接口获得的refresh_tokenscopestringopenid offline_access fbox email profileclient_idstring客户端编号client_secretstring客户端密码grant_typestringrefresh_token
注意 ：
HTTP的Content-Type（body的格式）为application/x-www-form-urlencoded
client_id\client_secret为服务器为各种客户端所创建的用户名、密码用于区分各类 客户端，请联系与贵公司对接的销售获取。
scope和grant_type为描述中所述固定值。
返回字段：
参数名类型参数描述access_tokenstringaccessTokenexpires_inintaccessToken的有效期refresh_tokenstringaccessToken过期后，刷新accessTokentoken_typestringaccessToken的类型(Bearer)固定值
返回码：
参数名类型401refresh_token过期或者错误429被服务器拒绝（调用过于频繁，客户端被禁止等）
调用案例
如下图：
总结
以上就是今天要讲的内容，本文仅仅简单介绍了FlexCloud云数据转HTTP开发接口对接基础操作，而FlexCloud提供了大量能使我们快速便捷有效的进行云数据转HTPP开发的具体部署和方法，比如：写值流程、获取信息接口、远程下载、盒子修改接口、盒子删除接口、报警接口、历史记录接口、监控点推送控制接口、数据推送（SignalR）等等操作，在此不做过多阐述，请同学们自行学习。
版权归原作者 一直在尽头 所有， 如有侵权，请联系我们删除。