ESP8266 – ESP8266HTTPClient库 – POST

位置导航: ESP8266库 / ESP8266HTTPClient库 / 本页

说明

此函数用于ESP8266备使用HTTP协议通过网络向服务器发送POST请求。

客户端与服务器通讯时最常被用到的方法是：GET 和 POST。
– GET – 从指定的资源请求数据。
– POST – 向指定的资源提交要被处理的数据

语法

http.POST(payload)
http.POST(payload, size)

参数

payload: 通过POST请求所发送的数据信息（该信息置于请求体中被发送）。该参数可使用字符串类型。
size: 通过POST请求所发送的数据字节数(此参数为可选参数，类型：size_t )。

返回值

服务器响应状态码（类型：int）

以下是常见的HTTP状态码（以下括号中内容为ESP8266HTTPClient库声明定义的HTTP状态码替代文字，具体内容可参考ESP8266库ESP8266HTTPClient.h文件中相应内容）：
– 200: 请求成功（HTTP_CODE_OK）
– 301: 资源（网页等）被永久转移到其它URL (HTTP_CODE_MOVED_PERMANENTLY)
– 404: 请求的资源（网页等）不存在(HTTP_CODE_NOT_FOUND)
– 500: 内部服务器错误(HTTP_CODE_INTERNAL_SERVER_ERROR)

示例程序

关于本函数的具体使用方法，请参考以下代码，尤其是代码中高亮的语句部分。

您将以下示例程序的WiFi连接信息修改后并且将本示例程序上传ESP8266开发板后，开发板随即会自动连接WiFi。WiFi连接成功后，ESP8266将会向http://quan.suning.com/getSysTime.do发送HTTP请求并通过串口监视器将响应信息通过串口监视器显示出来。

以下是本程序控制下，ESP8266发送的HTTP请求信息：

POST /getSysTime.do HTTP/1.1
Host: quan.suning.com
User-Agent: ESP8266HTTPClient
Connection: keep-alive
Accept-Encoding: identity;q=1,chunked;q=0.1,*;q=0
Content-Length: 9

date_test

POST /getSysTime.do HTTP/1.1

Host: quan.suning.com

User-Agent: ESP8266HTTPClient

Connection: keep-alive

Accept-Encoding: identity;q=1,chunked;q=0.1,*;q=0

Content-Length: 9

date_test

其中HTTP请求方法POST即是通过以下程序中的http.POST("date_test")语句来实现的。另外我们可以看到在以上的请求信息中，请求体部分包含有date_test。该信息即是通过http.POST("date_test")语句的参数实现的。

/**********************************************************************
  项目名称/Project          : 零基础入门学用物联网
  程序名称/Program name     : HTTPClient_demo_POST
  团队/Team                : 太极创客团队 / Taichi-Maker (www.taichi-maker.com)
  作者/Author              : Dapenson
  日期/Date（YYYYMMDD）     : 20200325
  程序目的/Purpose          :
  以苏宁易购的获取时间的公共api为例子,发起HTTP请求,并将获取到的数据信息打印到串口监视器中
  具体HTTP请求可参考自定义函数http_POST()内容
  -----------------------------------------------------------------------
  本示例程序为太极创客团队制作的《零基础入门学用物联网》中示例程序。
  该教程为对物联网开发感兴趣的朋友所设计和制作。如需了解更多该教程的信息，请参考以下网页：
  http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/iot-c/esp8266-nodemcu-web-client/http-request/
***********************************************************************/

#include <ESP8266WiFi.h>
#include <ESP8266HTTPClient.h>

//以苏宁易购api为例子获取时间数据
#define SERVER_IP "http://quan.suning.com/getSysTime.do"


//设置你的wifi接入信息
#ifndef STASSID
#define STASSID "taichimaker"
#define STAPSK  "12345678"
#endif

void setup() {

  //初始化串口设置
  Serial.begin(115200);
  Serial.println();

  //开始连接wifi
  WiFi.begin(STASSID, STAPSK);

  //等待WiFi连接,连接成功打印IP
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println("");
  Serial.print("Connected! IP address: ");
  Serial.println(WiFi.localIP());

}

void loop() {
  if ((WiFi.status() == WL_CONNECTED)) {
    http_post();
  }
  delay(10000);
}

void http_post() {

  //创建 WiFiClient 实例化对象
  WiFiClient client;

  //创建http对象
  HTTPClient http;

  //配置请求地址
  http.begin(client, SERVER_IP); //HTTP请求
  Serial.print("[HTTP] begin...\n");

  //启动连接并发送HTTP报头和报文
  int httpCode = http.POST(" ");
  Serial.print("[HTTP] POST...\n");

  //连接失败时 httpCode时为负
  if (httpCode > 0) {

    //将服务器响应头打印到串口
    Serial.printf("[HTTP] POST... code: %d\n", httpCode);

    //将从服务器获取的数据打印到串口
    if (httpCode == HTTP_CODE_OK) {
      const String& payload = http.getString();
      Serial.println("received payload:\n<<");
      Serial.println(payload);
      Serial.println(">>");
    }
  } else {
    Serial.printf("[HTTP] POST... failed, error: %s\n", http.errorToString(httpCode).c_str());
  }
  //关闭http连接
  http.end();
}

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

项目名称/Project : 零基础入门学用物联网

程序名称/Program name : HTTPClient_demo_POST

团队/Team : 太极创客团队 / Taichi-Maker (www.taichi-maker.com)

作者/Author : Dapenson

日期/Date（YYYYMMDD） : 20200325

程序目的/Purpose :

以苏宁易购的获取时间的公共api为例子,发起HTTP请求,并将获取到的数据信息打印到串口监视器中

具体HTTP请求可参考自定义函数http_POST()内容

-----------------------------------------------------------------------

本示例程序为太极创客团队制作的《零基础入门学用物联网》中示例程序。

该教程为对物联网开发感兴趣的朋友所设计和制作。如需了解更多该教程的信息，请参考以下网页：

http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/iot-c/esp8266-nodemcu-web-client/http-request/

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

#include <ESP8266WiFi.h>

#include <ESP8266HTTPClient.h>

//以苏宁易购api为例子获取时间数据

#define SERVER_IP "http://quan.suning.com/getSysTime.do"

//设置你的wifi接入信息

#ifndef STASSID

#define STASSID "taichimaker"

#define STAPSK "12345678"

#endif

void setup() {

//初始化串口设置

Serial.begin(115200);

Serial.println();

//开始连接wifi

WiFi.begin(STASSID, STAPSK);

//等待WiFi连接,连接成功打印IP

while (WiFi.status() != WL_CONNECTED) {

delay(500);

Serial.print(".");

}

Serial.println("");

Serial.print("Connected! IP address: ");

Serial.println(WiFi.localIP());

}

void loop() {

if ((WiFi.status() == WL_CONNECTED)) {

http_post();

}

delay(10000);

}

void http_post() {

//创建 WiFiClient 实例化对象

WiFiClient client;

//创建http对象

HTTPClient http;

//配置请求地址

http.begin(client, SERVER_IP); //HTTP请求

Serial.print("[HTTP] begin...\n");

//启动连接并发送HTTP报头和报文

int httpCode = http.POST(" ");

Serial.print("[HTTP] POST...\n");

//连接失败时 httpCode时为负

if (httpCode > 0) {

//将服务器响应头打印到串口

Serial.printf("[HTTP] POST... code: %d\n", httpCode);

//将从服务器获取的数据打印到串口

if (httpCode == HTTP_CODE_OK) {

const String& payload = http.getString();

Serial.println("received payload:\n<<");

Serial.println(payload);

Serial.println(">>");

}

} else {

Serial.printf("[HTTP] POST... failed, error: %s\n", http.errorToString(httpCode).c_str());

}

//关闭http连接

http.end();

}

说明

语法

参数

返回值

示例程序

相关内容