2023-05-12 开启多语言插件支持……

Http协议及Json格式简介(给yeelink使用者的)

技术流 苏 demo 2802℃ 0评论

高手,老鸟,请路过. 本说明忽略了Continue 100请求,代理,chunked等等高级话题.

Http协议基本:

分3部分, 请求行(request line), 头部键值对(header key-value), 请求体(body), 其中请求体是可选的, 尤其是GET/PUT请求

简单的GET请求

GET /v1.1/device/12825/sensor/20956/datapoints HTTP/1.1\r\n
Host: api.yeelink.net\r\n
Content-Length: 0\r\n
U-ApiKey: 121234132432143\r\n
\r\n

简单的POST请求

POST /v1.1/device/12825/sensor/20956/datapoints HTTP/1.1\r\n
Host: api.yeelink.net\r\n
Content-Length: 14\r\n
U-ApiKey: 121234132432143\r\n
\r\n
{"value":30.1}

请求行

POST /v1.1/device/12825/sensor/20956/datapoints HTTP/1.1\r\n

格式为

$method $uri HTTP/1.1\r\n

其中:

  • $method是请求方法,可以是GET,POST,PUT,DELETE 等
  • $uri是请求的路径, 例如网址是 http://wendal.net/404.html , 那么$uri就是 /404.html
  • HTTP/1.1 是固定字符,为http协议版本,可以用HTTP/1.1或HTTP/1.0
  • \r\n 换行,标记请求行的结束

头部键值对(header key-value)

Host: api.yeelink.net\r\n
Content-Length: 14\r\n
\r\n

注意, 这里总共3行,最后一个空行是headers的结束标志,必须有

header格式

$key: $value\r\n

其中:

  • $key 是”键”, 例如Host代表主机名的键, Content-Length代表请求体的长度的键
  • $value 是”值”, 例如主机名api.yeelink.net, 0等等
  • \r\n 换行,代表一个header的结束

header可以写很多很多行,但必须在所有header写完之后, 写入一个空行\r\n

有些header的值是严格限定的, 例如 Content-Length, 必须是请求体(body)的总字节数,不然服务器很有可能会拒绝.

请求体(body)

{"value":30.1}

约束:

  • 请求体可以是一个字符串,一个数字,一个图片,一个压缩包… http协议本身并不限制body里面的格式
  • 这部分对于GET/DELETE请求是不允许有的, 但对于POST/PUT,大部分情况下是必须的(不带body的POST请求在协议层面也是合法的)
  • 请求体,在header的空行之后算起, 总长度需要填入heaader的Content-Length键值对.
  • 在yeelink中, 非图片型传感器的上传数据, 是json字符串, 那么json字符串的字节长度,必须填入heaader的Content-Length键值对. 而图片型传感器, 请求体是图片的二进制数据(别转成hex字符串了), 总字节数一样要heaader的Content-Length键值对.
  • 再强调一次, Content-Length算的是字节长度, 是header空行之后的总字节数!!

json格式简介

json官网 http://json.org 里面有中文文档

json的基本格式是

{
 "value" : 31.0
}

上述数据以{开头, }结束, 代表一个键值对.

  • 其中的键为 value, 必须用双引号包起来
  • 这里演示的值是一个数值, 所以不需要双引号

值也是字符串的时候, 那么也需要字符串包起来:

{
 "value" : "I am ok"
}

代码怎么写?

这里假设用了透传工具(wifi,gprs,网线,等等), 实际使用时,请删掉中文注释

一个POST的例子(arduino代码, 其他单片机就自行选用Serial.print等价的方法,例如printf)

// 首先,写入请求行
Serial.print("POST /v1.1/device/12825/sensor/20956/datapoints HTTP/1.1\r\n");
// 然后,写入headers
// 先写入域名
Serial.print("Host: api.yeelink.net\r\n");
// 再写入密钥
Serial.print("U-ApiKey: 121234132432143\r\n");
// 接着写入请求体的长度
Serial.print("Content-Length: ");
Serial.print("14");//这需要算好,算对哦, 下面写入的请求体是 {"value:"30.1}
Serial.print("\r\n");//别忘记换行了
// 必要的headers都写完了,其他都不写了, 作为headers结束,必须有个空行
Serial.print("\r\n");
// 接下来是请求体, 
Serial.print("{\"value\":"); // 这里的\"是转义,算一个字节.
Serial.print("30.1"); // 假设上传的是数值型数据, 值为30.1
Serial.print("}");// 注意看, 需要匹配哦, 键值对.
// 已经结束写入了,不需要再换行之类的操作,因为这是请求体, 只有服务器认识里面的内容,不是http协议约束的部分

delay(3000); //等待3秒, 网络畅顺的话几十毫秒就返回了

while (Serial.available()) {
  int c = Serial.read();
  // 千万别写 Serial.write(c)
  // 这时候我们需要把读出来的数据写入到另外一个串口(例如声明个软串口), 这样才不会透传模块冲突, 也方便调试.
  MySoftSerial.write(c);
}

delay(10000); // yeelink的上传间隔是10s哦.

 

打赏

转载请注明:苏demo的别样人生 » Http协议及Json格式简介(给yeelink使用者的)

   如果本篇文章对您有帮助,欢迎向博主进行赞助,赞助时请写上您的用户名。
支付宝直接捐助帐号oracle_lee@qq.com 感谢支持!
喜欢 (0)or分享 (0)