本micropython 教程的目的是解释如何使用 micropython 和 urequests 库执行 http post 请求。这在esp32和esp8266上都进行了测试。

简介

本MicroPython教程旨在阐释如何借助MicroPython和urequests库（https://github.com/micropython/micropython-lib/blob/master/urequests/urequests.py）执行HTTP POST请求。本教程在esp32和ESP8266上均进行了测试。下文打印结果均出自ESP8266上的测试。

我们将把HTTP POST请求发送至一个假的在线测试REST API。该网站主页：http://jsonplaceholder.typicode.com/。其支持多条路径，而本教程将使用其中的/posts路径。但请注意，该路径名称与我们将要使用的POST方法互不相干。在此示例中，一条post对应一个表示用户写的（如在网站中）post的虚拟对象。另一方面，POST是我们将要使用的HTTP方法。

当然，为适用本教程，设备需事先连网，这样它才能够发送HTTP请求。请参阅这篇之前的帖子：ESP32 MicroPython教程：连接Wi-Fi网络，了解如何将运行MicroPython的设备连接到WiFi网络。如果你想让设备在启动后自动建立连接，请查看另一篇帖子：ESP32 / ESP8266 MicroPython教程：自动连接WiFi。在此示例中，我将MicroPython设置为设备启动后自动连接WiFi网络。

重要提示：本文撰写之际，所用的MicroPython版本默认包含urequests模块。因此，直接导入该模块即可，无需执行其他操作。但请注意，此情况或有变化，MicroPython新出版本的默认配置可能不再包含该模块，你需要另行配置。

代码

我们首先要做的是导入urequests模块，以获取执行HTTP POST请求所需的函数。

1 import urequests

然后通过调用urequests模块的post函数（https://github.com/micropython/micropython-lib/blob/master/urequests/urequests.py#L103）发送请求。此函数以我们要发送HTTP post请求的URL作为输入值。其还可接收键-参数列形式的其他参数，因为从该函数的定义即可看出，其在原型中定义了**kw参数。你可以通过这篇写得非常好的文章（https://pythontips.com/2013/08/04/args-and-kwargs-in-python-explained/）了解更多关于**kwargs的信息。

由于post函数是在其函数体部分调用request函数（https://github.com/micropython/micropython-lib/blob/master/urequests/urequests.py#L33），因此我们可以确认数据参数是我们能够传递的额外参数之一。这对应HTTP POST请求的函数体。

由于这只是一个展示如何使用该函数的简单示例，因此我们将只发送一个数据字符串作为函数体且不指定任何特定内容类型。当然，在实际情况下，我们还是希望能够指定内容类型并遵守其应用于请求体的格式。

请注意，该URL对应简介中提到的虚拟在线REST API网站的/posts路径。

1 response = urequests.post("http://jsonplaceholder.typicode.com/posts", data = "some dummy content")

请注意，此函数调用将返回一个Response类（https://github.com/micropython/micropython-lib/blob/master/urequests/urequests.py#L3）的对象，我们将其存储在变量中，以便稍后处理HTTP请求的结果。

图1展示了使用Postman函数（https://www.getpostman.com/apps）执行同一POST请求得到的结果。如图所示，我们将收到一个指示新来源已成功创建（ID为101的post对象）的响应，该响应与我们的请求内容无关。

即使我们继续发送请求，响应仍将保持不变，因为我们面对的是假的测试API。这就是指定内容类型或请求体非常有意义但我们无需费心进行此操作的原因。

欲了解如何使用Postman发送HTTP POST请求。

图1 – 使用Postman发送HTTP POST请求的输出结果。

最后，在MicroPython中获取请求的响应内容，为此只需访问Response对象的text属性即可。由于响应类型为JSON，因此我们还可以视其为内容已解析的字典对象，通过Response对象（其在实现中使用ujson库）的json函数检索该响应。

1 print(response.text)
2 print(response.json())

本教程所有命令的结果如图2所示。可以从中看出，我们获取的原始响应既可以是字符串格式，也可以是已解析的JSON对象。

图2 – 使用MicroPython发送HTTP POST请求的结果。

注：本文作者是Nuno Santos，他是一位和蔼可亲的电子和计算机工程师，住在葡萄牙里斯本 (Lisbon)。

查看更多ESP32/ESP8266教程和项目，请点击 ：

ESP32教程大全：http://mc.dfrobot.com.cn/forum.php?mod=viewthread&tid=271930

ESP32 tutorial：https://www.dfrobot.com/blog-964.html