ESPHome 2025.12.0-dev
Loading...
Searching...
No Matches
http_request_idf.cpp
Go to the documentation of this file.
1#include "http_request_idf.h"
2
3#ifdef USE_ESP_IDF
4
7
9#include "esphome/core/log.h"
10
11#if CONFIG_MBEDTLS_CERTIFICATE_BUNDLE
12#include "esp_crt_bundle.h"
13#endif
14
15#include "esp_task_wdt.h"
16
17namespace esphome {
18namespace http_request {
19
20static const char *const TAG = "http_request.idf";
21
22struct UserData {
23 const std::set<std::string> &collect_headers;
24 std::map<std::string, std::list<std::string>> response_headers;
25};
26
29 ESP_LOGCONFIG(TAG,
30 " Buffer Size RX: %u\n"
31 " Buffer Size TX: %u",
32 this->buffer_size_rx_, this->buffer_size_tx_);
33}
34
35esp_err_t HttpRequestIDF::http_event_handler(esp_http_client_event_t *evt) {
36 UserData *user_data = (UserData *) evt->user_data;
37
38 switch (evt->event_id) {
39 case HTTP_EVENT_ON_HEADER: {
40 const std::string header_name = str_lower_case(evt->header_key);
41 if (user_data->collect_headers.count(header_name)) {
42 const std::string header_value = evt->header_value;
43 ESP_LOGD(TAG, "Received response header, name: %s, value: %s", header_name.c_str(), header_value.c_str());
44 user_data->response_headers[header_name].push_back(header_value);
45 }
46 break;
47 }
48 default: {
49 break;
50 }
51 }
52 return ESP_OK;
53}
54
55std::shared_ptr<HttpContainer> HttpRequestIDF::perform(const std::string &url, const std::string &method,
56 const std::string &body,
57 const std::list<Header> &request_headers,
58 const std::set<std::string> &collect_headers) {
59 if (!network::is_connected()) {
60 this->status_momentary_error("failed", 1000);
61 ESP_LOGE(TAG, "HTTP Request failed; Not connected to network");
62 return nullptr;
63 }
64
65 esp_http_client_method_t method_idf;
66 if (method == "GET") {
67 method_idf = HTTP_METHOD_GET;
68 } else if (method == "POST") {
69 method_idf = HTTP_METHOD_POST;
70 } else if (method == "PUT") {
71 method_idf = HTTP_METHOD_PUT;
72 } else if (method == "DELETE") {
73 method_idf = HTTP_METHOD_DELETE;
74 } else if (method == "PATCH") {
75 method_idf = HTTP_METHOD_PATCH;
76 } else {
77 this->status_momentary_error("failed", 1000);
78 ESP_LOGE(TAG, "HTTP Request failed; Unsupported method");
79 return nullptr;
80 }
81
82 bool secure = url.find("https:") != std::string::npos;
83
84 esp_http_client_config_t config = {};
85
86 config.url = url.c_str();
87 config.method = method_idf;
88 config.timeout_ms = this->timeout_;
89 config.disable_auto_redirect = !this->follow_redirects_;
90 config.max_redirection_count = this->redirect_limit_;
91 config.auth_type = HTTP_AUTH_TYPE_BASIC;
92#if CONFIG_MBEDTLS_CERTIFICATE_BUNDLE
93 if (secure) {
94 config.crt_bundle_attach = esp_crt_bundle_attach;
95 }
96#endif
97
98 if (this->useragent_ != nullptr) {
99 config.user_agent = this->useragent_;
100 }
101
102 config.buffer_size = this->buffer_size_rx_;
103 config.buffer_size_tx = this->buffer_size_tx_;
104
105 const uint32_t start = millis();
107
108 config.event_handler = http_event_handler;
109 auto user_data = UserData{collect_headers, {}};
110 config.user_data = static_cast<void *>(&user_data);
111
112 esp_http_client_handle_t client = esp_http_client_init(&config);
113
114 std::shared_ptr<HttpContainerIDF> container = std::make_shared<HttpContainerIDF>(client);
115 container->set_parent(this);
116
117 container->set_secure(secure);
118
119 for (const auto &header : request_headers) {
120 esp_http_client_set_header(client, header.name.c_str(), header.value.c_str());
121 }
122
123 const int body_len = body.length();
124
125 esp_err_t err = esp_http_client_open(client, body_len);
126 if (err != ESP_OK) {
127 this->status_momentary_error("failed", 1000);
128 ESP_LOGE(TAG, "HTTP Request failed: %s", esp_err_to_name(err));
129 esp_http_client_cleanup(client);
130 return nullptr;
131 }
132
133 if (body_len > 0) {
134 int write_left = body_len;
135 int write_index = 0;
136 const char *buf = body.c_str();
137 while (write_left > 0) {
138 int written = esp_http_client_write(client, buf + write_index, write_left);
139 if (written < 0) {
140 err = ESP_FAIL;
141 break;
142 }
143 write_left -= written;
144 write_index += written;
145 }
146 }
147
148 if (err != ESP_OK) {
149 this->status_momentary_error("failed", 1000);
150 ESP_LOGE(TAG, "HTTP Request failed: %s", esp_err_to_name(err));
151 esp_http_client_cleanup(client);
152 return nullptr;
153 }
154
155 container->feed_wdt();
156 container->content_length = esp_http_client_fetch_headers(client);
157 container->feed_wdt();
158 container->status_code = esp_http_client_get_status_code(client);
159 container->feed_wdt();
160 container->set_response_headers(user_data.response_headers);
161 container->duration_ms = millis() - start;
162 if (is_success(container->status_code)) {
163 return container;
164 }
165
166 if (this->follow_redirects_) {
167 auto num_redirects = this->redirect_limit_;
168 while (is_redirect(container->status_code) && num_redirects > 0) {
169 err = esp_http_client_set_redirection(client);
170 if (err != ESP_OK) {
171 ESP_LOGE(TAG, "esp_http_client_set_redirection failed: %s", esp_err_to_name(err));
172 this->status_momentary_error("failed", 1000);
173 esp_http_client_cleanup(client);
174 return nullptr;
175 }
176#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
177 char redirect_url[256]{};
178 if (esp_http_client_get_url(client, redirect_url, sizeof(redirect_url) - 1) == ESP_OK) {
179 ESP_LOGV(TAG, "redirecting to url: %s", redirect_url);
180 }
181#endif
182 err = esp_http_client_open(client, 0);
183 if (err != ESP_OK) {
184 ESP_LOGE(TAG, "esp_http_client_open failed: %s", esp_err_to_name(err));
185 this->status_momentary_error("failed", 1000);
186 esp_http_client_cleanup(client);
187 return nullptr;
188 }
189
190 container->feed_wdt();
191 container->content_length = esp_http_client_fetch_headers(client);
192 container->feed_wdt();
193 container->status_code = esp_http_client_get_status_code(client);
194 container->feed_wdt();
195 container->duration_ms = millis() - start;
196 if (is_success(container->status_code)) {
197 return container;
198 }
199
200 num_redirects--;
201 }
202
203 if (num_redirects == 0) {
204 ESP_LOGW(TAG, "Reach redirect limit count=%d", this->redirect_limit_);
205 }
206 }
207
208 ESP_LOGE(TAG, "HTTP Request failed; URL: %s; Code: %d", url.c_str(), container->status_code);
209 this->status_momentary_error("failed", 1000);
210 return container;
211}
212
213int HttpContainerIDF::read(uint8_t *buf, size_t max_len) {
214 const uint32_t start = millis();
215 watchdog::WatchdogManager wdm(this->parent_->get_watchdog_timeout());
216
217 int bufsize = std::min(max_len, this->content_length - this->bytes_read_);
218
219 if (bufsize == 0) {
220 this->duration_ms += (millis() - start);
221 return 0;
222 }
223
224 this->feed_wdt();
225 int read_len = esp_http_client_read(this->client_, (char *) buf, bufsize);
226 this->feed_wdt();
227 this->bytes_read_ += read_len;
228
229 this->duration_ms += (millis() - start);
230
231 return read_len;
232}
233
235 watchdog::WatchdogManager wdm(this->parent_->get_watchdog_timeout());
236
237 esp_http_client_close(this->client_);
238 esp_http_client_cleanup(this->client_);
239}
240
242 // Tests to see if the executing task has a watchdog timer attached
243 if (esp_task_wdt_status(nullptr) == ESP_OK) {
244 App.feed_wdt();
245 }
246}
247
248} // namespace http_request
249} // namespace esphome
250
251#endif // USE_ESP_IDF
void feed_wdt(uint32_t time=0)
void status_momentary_error(const std::string &name, uint32_t length=5000)
int read(uint8_t *buf, size_t max_len) override
void feed_wdt()
Feeds the watchdog timer if the executing task has one attached.
std::shared_ptr< HttpContainer > start(const std::string &url, const std::string &method, const std::string &body, const std::list< Header > &request_headers)
static esp_err_t http_event_handler(esp_http_client_event_t *evt)
Monitors the http client events to gather response headers.
std::shared_ptr< HttpContainer > perform(const std::string &url, const std::string &method, const std::string &body, const std::list< Header > &request_headers, const std::set< std::string > &collect_headers) override
bool is_success(int const status)
Checks if the given HTTP status code indicates a successful request.
bool is_redirect(int const status)
Returns true if the HTTP status code is a redirect.
bool is_connected()
Return whether the node is connected to the network (through wifi, eth, ...)
Definition util.cpp:26
Providing packet encoding functions for exchanging data with a remote host.
Definition a01nyub.cpp:7
std::string str_lower_case(const std::string &str)
Convert the string to lower case.
Definition helpers.cpp:189
uint32_t IRAM_ATTR HOT millis()
Definition core.cpp:30
Application App
Global storage of Application pointer - only one Application can exist.