1. HTTP/HTTPS简介
HTTP（全称：Hyper Text Transfer Protocol，超文本传输协议）是互联网上应用最为广泛的一种网络协议，是一个客户端和服务器请求和应答标准，用于从WWW服务器传输超文本到本地的传输协议。
而HTTPS（全称：Hyper Text Transfer Protocol over SecureSocket Layer）是以安全为目标的HTTP通道，在原有HTTP的基础上通过传输加密和身份认证（即增加SSL/TSL安全访问协议）保证了传输过程的安全性。
1.1 HTTP和HTTPS的区别
HTTP和HTTPS的区别如下所示。
1.2 请求和响应
典型的HTTP/HTTPS通讯就是应用在浏览器与网页服务器之间，浏览器即为客户端，负责发出请求，接收报文，渲染显示效果。网页服务器即为服务器，负责应答请求，管理服务器文件、处理具体业务。而在某些情况中，HTTP可以作为信息交换的通讯规则。
客户端需要资源时发送出来的即为请求报文，服务器接收到请求后向客户端返回的就是响应报文，HTTP规定了请求报文和响应报文的格式。
请求报文格式如下所示。
对于本文而言，我们主要关注请求方法和URL即可。
响应报文示例如下所示，主要组成部分有：
l 状态行（包含协议版本、状态值、状态短语）；
l 响应消息头（以键值对的形式存在，例如时间、数据类型、数据长度等）；
l 空行（用于区分报文头和响应正文）；
l 响应正文（对于网页而言，常见的是html代码，也可以是音视频文件、图片，通常是消息报头的Content-Type指定）。
1.3 URL
假设我们搭建了一个环境检测服务器系统，用于采集、记录全市各个观测点的环境数据，假定服务器的存放结构如下所示，此服务器在公网上的域名为www.huanjin.com，里面有两个设备，每个设备存放了不同日子的气温数据，当客户端需要调取具体设备具体数据时，则需要提交一个唯一的路径给服务器查找，这个唯一路径就是URL。
URL（Uniform Resource Locator，统一资源定位符），存放在请求报文的请求行内，充当路标作用。当我们浏览网页时，点击进入不同的组件，浏览器就会自动的帮我们填充不同的URL，地址的构成如下所示。完整的URL包含：协议部分、网址部分、文件地址。
具体内容如下所示。
例如我们想获取环境检测服务器中设备1的12月25号数据，填写的请求报文就是，GET请求，URL为“http://www.huanjin.com/Device-1/日期数据/20211225”。
URL还可以携带变量信息，名称为URL查询字符串，形式为：
https://www.Adblock.com/s?a=123&b=234
变量存放在URL结尾处，以“？”开头，以“参数名=值”的键值对形式存放，多个参数用“&”分割。
1.4 HTTPS使用要点
通过以上叙述可知，使用HTTPS需要时刻围绕以下几点：
l CA证书，HTTPS协议用SSL/TSL；
l 发送数据使用POst请求，服务器地址使用URL格式表示；
l 接收数据、文件使用GET请求，服务器地址使用URL格式表示；
我司的easyeai-api软件开源库将复杂的报文格式、收发操作做了统一的封装，为客户提供简单便捷的调用方式实现HTTP/HTTPS通讯功能。
2. 快速上手
2.1 开发环境准备
如果您初次阅读此文档，请阅读《入门指南/开发环境准备/Easy-Eai编译环境准备与更新》，并按照其相关的操作，进行编译环境的部署。
在PC端Ubuntu系统中执行run脚本，进入EASY-EAI编译环境，具体如下所示。
cd ~/develop_environment ./run.sh 2204
2.2 源码下载以及例程编译
在EASY-EAI编译环境下创建存放源码仓库的管理目录：
cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit
通过git工具，在管理目录内克隆远程仓库
git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-1126B.git
注：
* 此处可能会因网络原因造成卡顿，请耐心等待。
* 如果实在要在gitHub网页上下载，也要把整个仓库下载下来，不能单独下载本实例对应的目录。
进入到对应的例程目录执行编译操作，具体命令如下所示：
cd EASY-EAI-Toolkit-1126B/Demos/netProtocol-http/ ./build.sh
注：
* 由于依赖库部署在板卡上，因此交叉编译过程中必须保持/mnt挂载。
2.3 例程运行
通过串口调试或ssh调试，进入板卡后台，定位到例程部署的位置，如下所示：
cd /userdata/Demo/netProtocol-http
运行例程命令如下所示：
./test-http_server & ./test-http_client
2.4 运行效果
执行效果如下所示。
3. HTTPS库函数说明
本章节介绍EASY EAI的HTTPS库函数的使用方法。
3.1 引用方式
EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库，此处列出工程中需要链接的库以及头文件等，方便用户直接添加。
API源代码路径为EASY-EAI-Toolkit-1126B/easyeai-api/netProtocol/http/。用户可通过源代码了解接口实现，甚至可对源码进行修改。
3.2 设置证书
设置证书的函数原型为：
void set_customer_crt(const char *crt_file);
具体介绍如下所示。
3.3 向HTTP/HTTPS服务器发送form-data数据
3.3.1 清除form_data缓存
清除缓存的函数原型为：
void clear_multipart();
具体介绍如下所示。
3.3.2 填充form_data缓存
填充缓存的函数原型如下所示，传输的数据以键值对的形式传输。
void add_multipart_form_data(const char *key, const char *value);
具体介绍如下所示。
3.3.3 发送form-data数据
由于HTTP和HTTPS的加密方式有所区别，故分别定义了两个函数，但参数一致，函数原型如下所示。
int32_t send_data_to_Http(const char *server, const char *func, char *result, uint32_t result_lenth); int32_t send_data_to_Https(const char *server, const char *func, char *result, uint32_t result_lenth);
具体介绍如下所示。
3.4 向HTTP/HTTPS服务器发送json数据
由于HTTP和HTTPS的加密方式有所区别，故分别定义了两个函数，但参数一致，函数原型如下所示。
int32_t send_json_to_Http(const char *server, const char *func, const char *json, char *result, uint32_t result_length); int32_t send_json_to_Https(const char *server, const char *func, const char *json, char *result, uint32_t result_length);
具体介绍如下所示。
3.5 向HTTP/HTTPS服务器获取文件
由于HTTP和HTTPS的加密方式有所区别，故分别定义了两个函数，但参数一致，函数原型如下所示。
int32_t get_file_from_https(const char *url, const char *func, const char *filePath); int32_t get_file_from_http(const char *url, const char *func, const char *filePath);
具体介绍如下所示。
4. 使用实例
示例代码路径为EASY-EAI-Toolkit-1126B/Demos/netProtocol-http/test-http_client.c。
4.1 设置CRT密钥文件
设置密钥文件操作如下所示。
set_customer_crt("/userdata/customer.crt");
4.2 发送form_data数据
4.2.1 填充数据
清空form_data数据缓冲区，然后填充form_data缓冲区数据。
clear_multipart(); add_multipart_form_data("name", "gzlmo"); add_multipart_form_data("id", "888888"); add_multipart_form_data("pwd", "123456");
4.2.2 发送数据
发送操作如下所示。
send_data_to_Http("192.168.3.191:50000", "/add", res, sizeof(res));
4.3 发送json数据
发送操作如下所示。
send_json_to_Http("192.168.3.191:50000", "/add", "{name : "gzlmo"}", res, sizeof(res));
推荐阅读：
成本可降低22% 半导体巨头拟开发3.3D先进封装技术！这些概念股具备高增长潜力
煤炭巨头中国神华跨界新能源，国能（南雄）新能源有限公司正式成立
