#pragma once #include #include #include #include #include #include #include "esphome/components/json/json_util.h" #include "esphome/core/application.h" #include "esphome/core/automation.h" #include "esphome/core/component.h" #include "esphome/core/defines.h" #include "esphome/core/helpers.h" #include "esphome/core/log.h" namespace esphome::http_request { struct Header { std::string name; std::string value; }; // Some common HTTP status codes enum HttpStatus { HTTP_STATUS_OK = 200, HTTP_STATUS_NO_CONTENT = 204, HTTP_STATUS_PARTIAL_CONTENT = 206, /* 3xx - Redirection */ HTTP_STATUS_MULTIPLE_CHOICES = 300, HTTP_STATUS_MOVED_PERMANENTLY = 301, HTTP_STATUS_FOUND = 302, HTTP_STATUS_SEE_OTHER = 303, HTTP_STATUS_NOT_MODIFIED = 304, HTTP_STATUS_TEMPORARY_REDIRECT = 307, HTTP_STATUS_PERMANENT_REDIRECT = 308, /* 4XX - CLIENT ERROR */ HTTP_STATUS_BAD_REQUEST = 400, HTTP_STATUS_UNAUTHORIZED = 401, HTTP_STATUS_FORBIDDEN = 403, HTTP_STATUS_NOT_FOUND = 404, HTTP_STATUS_METHOD_NOT_ALLOWED = 405, HTTP_STATUS_NOT_ACCEPTABLE = 406, HTTP_STATUS_LENGTH_REQUIRED = 411, /* 5xx - Server Error */ HTTP_STATUS_INTERNAL_ERROR = 500 }; /** * @brief Returns true if the HTTP status code is a redirect. * * @param status the HTTP status code to check * @return true if the status code is a redirect, false otherwise */ inline bool is_redirect(int const status) { switch (status) { case HTTP_STATUS_MOVED_PERMANENTLY: case HTTP_STATUS_FOUND: case HTTP_STATUS_SEE_OTHER: case HTTP_STATUS_TEMPORARY_REDIRECT: case HTTP_STATUS_PERMANENT_REDIRECT: return true; default: return false; } } /** * @brief Checks if the given HTTP status code indicates a successful request. * * A successful request is one where the status code is in the range 200-299 * * @param status the HTTP status code to check * @return true if the status code indicates a successful request, false otherwise */ inline bool is_success(int const status) { return status >= HTTP_STATUS_OK && status < HTTP_STATUS_MULTIPLE_CHOICES; } class HttpRequestComponent; class HttpContainer : public Parented { public: virtual ~HttpContainer() = default; size_t content_length; int status_code; uint32_t duration_ms; virtual int read(uint8_t *buf, size_t max_len) = 0; virtual void end() = 0; void set_secure(bool secure) { this->secure_ = secure; } size_t get_bytes_read() const { return this->bytes_read_; } /** * @brief Get response headers. * * @return The key is the lower case response header name, the value is the header value. */ std::map> get_response_headers() { return this->response_headers_; } std::string get_response_header(const std::string &header_name); protected: size_t bytes_read_{0}; bool secure_{false}; std::map> response_headers_{}; }; class HttpRequestResponseTrigger : public Trigger, std::string &> { public: void process(const std::shared_ptr &container, std::string &response_body) { this->trigger(container, response_body); } }; class HttpRequestComponent : public Component { public: void dump_config() override; float get_setup_priority() const override { return setup_priority::AFTER_WIFI; } void set_useragent(const char *useragent) { this->useragent_ = useragent; } void set_timeout(uint32_t timeout) { this->timeout_ = timeout; } void set_watchdog_timeout(uint32_t watchdog_timeout) { this->watchdog_timeout_ = watchdog_timeout; } uint32_t get_watchdog_timeout() const { return this->watchdog_timeout_; } void set_follow_redirects(bool follow_redirects) { this->follow_redirects_ = follow_redirects; } void set_redirect_limit(uint16_t limit) { this->redirect_limit_ = limit; } std::shared_ptr get(const std::string &url) { return this->start(url, "GET", "", {}); } std::shared_ptr get(const std::string &url, const std::list
&request_headers) { return this->start(url, "GET", "", request_headers); } std::shared_ptr get(const std::string &url, const std::list
&request_headers, const std::set &collect_headers) { return this->start(url, "GET", "", request_headers, collect_headers); } std::shared_ptr post(const std::string &url, const std::string &body) { return this->start(url, "POST", body, {}); } std::shared_ptr post(const std::string &url, const std::string &body, const std::list
&request_headers) { return this->start(url, "POST", body, request_headers); } std::shared_ptr post(const std::string &url, const std::string &body, const std::list
&request_headers, const std::set &collect_headers) { return this->start(url, "POST", body, request_headers, collect_headers); } std::shared_ptr start(const std::string &url, const std::string &method, const std::string &body, const std::list
&request_headers) { return this->start(url, method, body, request_headers, {}); } std::shared_ptr start(const std::string &url, const std::string &method, const std::string &body, const std::list
&request_headers, const std::set &collect_headers) { std::set lower_case_collect_headers; for (const std::string &collect_header : collect_headers) { lower_case_collect_headers.insert(str_lower_case(collect_header)); } return this->perform(url, method, body, request_headers, lower_case_collect_headers); } protected: virtual std::shared_ptr perform(const std::string &url, const std::string &method, const std::string &body, const std::list
&request_headers, const std::set &collect_headers) = 0; const char *useragent_{nullptr}; bool follow_redirects_{}; uint16_t redirect_limit_{}; uint32_t timeout_{4500}; uint32_t watchdog_timeout_{0}; }; template class HttpRequestSendAction : public Action { public: HttpRequestSendAction(HttpRequestComponent *parent) : parent_(parent) {} TEMPLATABLE_VALUE(std::string, url) TEMPLATABLE_VALUE(const char *, method) TEMPLATABLE_VALUE(std::string, body) #ifdef USE_HTTP_REQUEST_RESPONSE TEMPLATABLE_VALUE(bool, capture_response) #endif void add_request_header(const char *key, TemplatableValue value) { this->request_headers_.insert({key, value}); } void add_collect_header(const char *value) { this->collect_headers_.insert(value); } void add_json(const char *key, TemplatableValue value) { this->json_.insert({key, value}); } void set_json(std::function json_func) { this->json_func_ = json_func; } #ifdef USE_HTTP_REQUEST_RESPONSE Trigger, std::string &, Ts...> *get_success_trigger_with_response() const { return this->success_trigger_with_response_; } #endif Trigger, Ts...> *get_success_trigger() const { return this->success_trigger_; } Trigger *get_error_trigger() const { return this->error_trigger_; } void set_max_response_buffer_size(size_t max_response_buffer_size) { this->max_response_buffer_size_ = max_response_buffer_size; } void play(const Ts &...x) override { std::string body; if (this->body_.has_value()) { body = this->body_.value(x...); } if (!this->json_.empty()) { auto f = std::bind(&HttpRequestSendAction::encode_json_, this, x..., std::placeholders::_1); body = json::build_json(f); } if (this->json_func_ != nullptr) { auto f = std::bind(&HttpRequestSendAction::encode_json_func_, this, x..., std::placeholders::_1); body = json::build_json(f); } std::list
request_headers; for (const auto &item : this->request_headers_) { auto val = item.second; Header header; header.name = item.first; header.value = val.value(x...); request_headers.push_back(header); } auto container = this->parent_->start(this->url_.value(x...), this->method_.value(x...), body, request_headers, this->collect_headers_); auto captured_args = std::make_tuple(x...); if (container == nullptr) { std::apply([this](Ts... captured_args_inner) { this->error_trigger_->trigger(captured_args_inner...); }, captured_args); return; } size_t max_length = this->max_response_buffer_size_; #ifdef USE_HTTP_REQUEST_RESPONSE if (this->capture_response_.value(x...)) { std::string response_body; RAMAllocator allocator; uint8_t *buf = allocator.allocate(max_length); if (buf != nullptr) { size_t read_index = 0; while (container->get_bytes_read() < max_length) { int read = container->read(buf + read_index, std::min(max_length - read_index, 512)); if (read <= 0) { break; } App.feed_wdt(); yield(); read_index += read; } response_body.reserve(read_index); response_body.assign((char *) buf, read_index); allocator.deallocate(buf, max_length); } std::apply( [this, &container, &response_body](Ts... captured_args_inner) { this->success_trigger_with_response_->trigger(container, response_body, captured_args_inner...); }, captured_args); } else #endif { std::apply([this, &container]( Ts... captured_args_inner) { this->success_trigger_->trigger(container, captured_args_inner...); }, captured_args); } container->end(); } protected: void encode_json_(Ts... x, JsonObject root) { for (const auto &item : this->json_) { auto val = item.second; root[item.first] = val.value(x...); } } void encode_json_func_(Ts... x, JsonObject root) { this->json_func_(x..., root); } HttpRequestComponent *parent_; std::map> request_headers_{}; std::set collect_headers_{"content-type", "content-length"}; std::map> json_{}; std::function json_func_{nullptr}; #ifdef USE_HTTP_REQUEST_RESPONSE Trigger, std::string &, Ts...> *success_trigger_with_response_ = new Trigger, std::string &, Ts...>(); #endif Trigger, Ts...> *success_trigger_ = new Trigger, Ts...>(); Trigger *error_trigger_ = new Trigger(); size_t max_response_buffer_size_{SIZE_MAX}; }; } // namespace esphome::http_request