接口地址

Http服务器：http://eapi.wogrid.com

TCP服务器：eapi.wogrid.com 端口：13002

ProtoBuf描述文件下载：http://document.wogrid.com/TelemetryDataBuf-new.proto

格式约定

API协议用于平台与平台的对接，第三方客户端不能直接使用此协议

客户端与服务端通信方式包括HTTP、TCP和UDP

HTTP接口使用Restful接口规范，请求及响应编码为UTF-8,

TCP多字节传输时，字节序采用网络字节序即大端模式

API接口调用流程

Http接口响应结构体

    {
        "state":0,//0为成功，其它为失败
        "message":"操作成功",//操作描述，当state不为0时参见此值
        "totalNum":101,//记录总数，在列表接口返回时有此值
        "content":XXX //实际返回数，可能为list或map
    }

用户签名验证

云平台通过使用AccessKeyID、AccessKeySecret对称加密的方法来验证某个请求的发送者身份，AccessKeyID用于标识用户，AccessKeySecret是用户用于加密签名字符串的密钥，AccessKeySecret必须保密。

用户使用AccessKeyID、AccessKeySecret换取AccessToken，以后所有向云平发起的Http请求头中都必须携带AccessToken

AccessToken长期可用，但再次调用换取AccessToken接口后，上次的AccessToken将失效

换取AccessToken(鉴权)

接口地址	请求方式	说明
/eapi/auth/getToken	POST	通过AccessKeyID、AccessKeySecret换取accessToken和companyId

接口参数

参数名	参数类型	是否必须	参数说明
accessKeyId	String	是	AccessKeyID
encryptStr	String	是	encryptStr=MD5(AccessKeyID+AccessKeySecret+timeStamp)
timeStamp	long	是	从1970年1月1日（UTC/GMT的午夜）开始所经过的秒毫

接口响应

参数名	参数类型	是否必须	参数说明
companyId	int	是	云平台分配的用户ID
accessToken	String	是	AccessToken

注意：在后续的Http请求头中需携带companyId和accessToken，请求头名称如下：

头名称	值
x-cid	companyId
x-token	accessToken

格式约定#

API接口调用流程#

Http接口响应结构体#

用户签名验证#

换取AccessToken(鉴权)#

格式约定

API接口调用流程

Http接口响应结构体

用户签名验证

换取AccessToken(鉴权)