久久久久久久999_99精品久久精品一区二区爱城_成人欧美一区二区三区在线播放_国产精品日本一区二区不卡视频_国产午夜视频_欧美精品在线观看免费

 找回密碼
 立即注冊

QQ登錄

只需一步，快速開始

帖子
查看: 7179|回復: 1
收起左側

arduino JSON庫和httppacket庫分享

[復制鏈接]
ID:404913 發(fā)表于 2018-10-2 18:51 | 顯示全部樓層 |閱讀模式
好多人找的arduinojson庫和httppacket庫文件包：
0.png

HTTP數(shù)據(jù)封裝Ardiuno SDK說明文檔

RestfulAPI包括資源的增、刪、改、查四類操作，其中刪、查操作不帶HTTP內容，只有HTTP報頭。增、改操作有HTTP報頭，后面帶有JSON格式HTTP內容。報頭數(shù)據(jù)URL帶有可選參數(shù)，都是以“？”開始，以“&”分隔。下列操作的HTTP報文，紅色代表有URL可選參數(shù)。

HTTP報由報頭和HTTP內容組成。HTTP內容是JSON格式字符串，可以通過Ardiuno的JSON庫實現(xiàn)HTTP內容的封裝，本文檔主要說明HTTP包頭封裝的封裝方法和接口實現(xiàn)。

1．報文總結
1.1 查詢操作
//查看用戶
GET /user HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//查詢設備
GET /devices/<devices_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
GET /devices HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//查看數(shù)據(jù)流
GET /devices/<devices_id>/datastreams/<datastream_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
GET /devices/<devices_id>/datastreams?datastream_ids=temp,gps HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//查看數(shù)據(jù)點
GET /devices/<devices_id>/datapoints HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//查看觸發(fā)器
GET /triggers/<trigger_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//查看API權限
GET /keys HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//查看二進制數(shù)據(jù)
GET /bindata/<index> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//RestAPI日志查詢
GET /logs/<device_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//歷史數(shù)據(jù)查詢
GET /datapoints HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
1.2 新增操作
//新增設備
POST /devices HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//新增數(shù)據(jù)流
POST /devices/<devices_id>/datastreams HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//新增數(shù)據(jù)點
POST /devices/<devices_id>/datapoints HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//新增觸發(fā)器
POST /triggers HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//新增API權限
POST /keys HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
///新增二進制數(shù)據(jù)
POST /bindata HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}

1.3 更新操作
//更新設備
PUT /devices/<devices_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//更新數(shù)據(jù)流
PUT /devices/<devices_id>/datastreams/<datastream_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//更新觸發(fā)器
PUT /triggers/<trigger_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//更新API權限
PUT /keys/<key_string> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
//發(fā)送數(shù)據(jù)到edp設備
POST /cmds/<device_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
Content-Length: ***\r\n
\r\n
{"JASON"}
1.4 刪除操作
//刪除設備
DELETE /devices/<devices_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//刪除數(shù)據(jù)流
DELETE /devices/<devices_id>/datastreams/<datastream_id>  HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//刪除數(shù)據(jù)點
DELETE /devices/<devices_id>/datapoints HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//刪除觸發(fā)器
DELETE /triggers/<trigger_id> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//刪除API權限
DELETE /keys/<key_string> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n
//刪除二進制數(shù)據(jù)
DELETE /bindata/<index> HTTP/1.1\r\n
api-key:<your_api_key>\r\n
Host:api.heclouds.com\r\n
\r\n

2．SDK對外接口說明

/**********************************************************************
*  功能描述: 設置http包頭主機地址字符串
*  @param param1   char* hostAddr  服務器地址字符串指針

*  @return void

**********************************************************************/
void HttpPacketHead::setHostAddress(char* hostAddr)

/**********************************************************************
*  功能描述: 更新單個URL參數(shù)
*  @param param1   char* key      參數(shù)名字字符串指針
*  @param param2   char* value    參數(shù)的值字符串指針

*  @return void

**********************************************************************/
void HttpPacketHead::updateUrlParameterWith(char* key, char* value)

/**********************************************************************
*  功能描述: 清除所有之前設置的URL參數(shù)
*  @param void

*  @return void

**********************************************************************/
void HttpPacketHead::clearUrlParameter(void)

/**********************************************************************
*  功能描述:刪除一個之前已經(jīng)存在的URL參數(shù)，如果沒有這
*                        個參數(shù) 不做任何操作
*  @param char* key   參數(shù)名稱

*  @return void

**********************************************************************/
void HttpPacketHead::removeUrlParameter(char* key)

/**********************************************************************
*  功能描述:添加一個url 參數(shù)http包中，如果存在該參數(shù)，
*                       不做任何操作.
*  @param1 char* key       參數(shù)名稱
*  @param2 char* value     參數(shù)值

*  @return  void

**********************************************************************/
void HttpPacketHead::addUrlParameter(char* key, char* value)

/**********************************************************************
*  功能描述:設置http包中要要訪問的設備id
*  @param1 char* Dev_Id       設備ID 字符串

*  @return  void

**********************************************************************/
void HttpPacketHead::setDevId(char* Dev_Id)

/**********************************************************************
*  功能描述:設置http包中要要訪問的數(shù)據(jù)流ID
*  @param1 char* StreamId      數(shù)據(jù)流ID 字符串

*  @return  void

**********************************************************************/
void HttpPacketHead::setDataStreamId(char* StreamId)

/**********************************************************************
*  功能描述:設置http包中要要訪問的觸發(fā)器ID
*  @param1 char* TrigId      觸發(fā)器ID 字符串

*  @return  void

**********************************************************************/
void HttpPacketHead::setTriggerId(char* TrigId)

/**********************************************************************
*  功能描述:設置http包中要要訪問的bin文件索引
*  @param1 char* Idx    文件索引

*  @return  void

**********************************************************************/
void HttpPacketHead::setBinIdx(char* Idx)

/**********************************************************************
*  功能描述:添加一個API key，只有在API 更新操作中才會設置.
*  @param1 char* key    key字符串

*  @return  void

**********************************************************************/
void HttpPacketHead::addAPIKey(char* key)

/**********************************************************************
*  功能描述:設置訪問設備所需的密鑰.
*  @param1 char* key    key字符串

*  @return  void

**********************************************************************/
void HttpPacketHead::setAccessKey(char* key)

/**********************************************************************
*  功能描述:產(chǎn)生http 數(shù)據(jù)報頭，僅限POST、PUT操作
*  @param1 OPS_TYPE     operType          操作類型
*  @param2 RESRC_TYPE  type                資源類型
*  @param3 char* jsonData            http內容json結構

*  @return  RET_ERR      產(chǎn)生數(shù)據(jù)包失敗，可能因為參數(shù)傳入不當

              RET_OK     產(chǎn)生數(shù)據(jù)包成功

**********************************************************************/
intHttpPacketHead::createCmdPacket(OPS_TYPE operType, RESRC_TYPE type, char* jsonData)


/**********************************************************************

int HttpPacketHead::createCmdPacket(OPS_TYPE operType, RESRC_TYPEtype)

*  功能描述:產(chǎn)生http 數(shù)據(jù)報頭，僅限DELETE、GET操作
*  @param1 OPS_TYPE     operType          操作類型
*  @param2 RESRC_TYPE  type                資源類型

*  @return  RET_ERR      產(chǎn)生數(shù)據(jù)包失敗，可能因為參數(shù)傳入不當

              RET_OK      產(chǎn)生數(shù)據(jù)包成功
**********************************************************************/

3.資源類型說明
    TYPE_USER                       用戶
    TYPE_DEV                  設備
    TYPE_DATASTREAM                 數(shù)據(jù)流
    TYPE_DATAPOINT                    數(shù)據(jù)點
    TYPE_TRIGGER                     觸發(fā)器
    TYPE_APIKEY                      API-KEY
    TYPE_BINDATA                     二進制數(shù)據(jù)
    TYPE_APILOG              API日志  
    TYPE_HISTORYDATA             歷史數(shù)據(jù)

4. 操作類型說明
POST                                 新增
    PUT                                        更新
    GET                                       查詢
    DELETE                               刪除

5. 約束限制
1）一個HTTP報報頭最大不能超過300字節(jié)；
2）一個HTTP報URL可選參數(shù)個數(shù)不超過7個；
3）一個HTTP報所有URL參數(shù)字符串總長度不超過150字節(jié)。

6. 編程舉例
Ardiuno代碼段：

  HttpPacketHead packet;

packet.setHostAddress("api.heclouds.com");//設置主機地址

packet.setDevId("70290");//設置設備ID

packet.setAccessKey("<Your access api-key>");//設置訪問密鑰

packet.addUrlParameter("datastream_ids", "temp");//添加URL參數(shù)

packet.addUrlParameter("datastream_ids", "gps");//添加URL參數(shù)

packet.createCmdPacket(GET, TYPE_DATASTREAM);//產(chǎn)生查詢數(shù)據(jù)流的報頭

  Serial.print(packet.content);


輸出為：
GET /devices/70290/datastreams/?datastream_ids=temp,gps HTTP/1.1
api-key:<Your access api-key>
Host:api.heclouds.com
具體使用方法請參照示例程序。

全部資料51hei下載地址：
ArdiunoHttpSDK.rar (1.12 MB, 下載次數(shù): 100)

回復

使用道具 舉報

ID:139761 發(fā)表于 2019-2-6 17:00 | 顯示全部樓層
感謝感謝
回復

使用道具 舉報

您需要登錄后才可以回帖 登錄 | 立即注冊

本版積分規(guī)則

小黑屋|51黑電子論壇 |51黑電子論壇6群 QQ 管理員QQ:125739409;技術交流QQ群281945664

Powered by 單片機教程網(wǎng)

快速回復 返回頂部 返回列表
主站蜘蛛池模板： 黄色av一区 | 一级欧美一级日韩 | 18成人免费观看网站 | 成人在线免费视频观看 | 免费黄色网址在线观看 | 久久伊人av| 亚洲国产日韩在线 | 日韩一级黄 | 午夜视频免费看 | 国产视频一区二区在线 | 久久精品一区二区国产 | 久久99精品久久久久久琪琪 | 国产精品久久久999 成人在线国产 | 亚洲欧美日韩国产 | 日韩小视频在线观看 | 国产精品三级视频 | a天堂视频 | 亚洲综合欧美 | 亚洲欧美日韩国产 | 精品一区久久 | 自拍偷拍18p | 特黄aaaaaaaaa真人毛片 | 超碰成人福利 | 成人小视频在线观看 | 国产一区免费视频 | 在线一区二区三区四区 | 精品一区av | 中文字幕免费高清 | 国产专区在线播放 | 99热这里 | 中文字幕亚洲天堂 | 国产精品麻豆免费版 | 青娱乐99 | 特黄aaaaaaaaa真人毛片 | 欧美理论在线观看 | 精品亚洲国产成人av制服丝袜 | 国产操操操| 欧美激情第二页 | 欧美性猛交xxxx乱大交退制版 | 成人在线a | 日韩精品免费观看 |