[{"data":1,"prerenderedAt":741},["ShallowReactive",2],{"node-red-\u002Fnode-red\u002Fcore-nodes\u002Fhttp-request":3},{"id":4,"title":5,"body":6,"description":722,"extension":734,"meta":735,"navigation":736,"path":737,"seo":738,"stem":739,"__hash__":740},"nodeRed\u002Fnode-red\u002Fcore-nodes\u002Fhttp-request.md","Node-RED - HTTP request Node",{"type":7,"value":8,"toc":721},"minimark",[9,14,19,23,26,30,33,259,263,288,291,295,300,305,311,314,320,323,329,332,338,341,345,387,391],[10,11,13],"h1",{"id":12},"http-request","HTTP request",[15,16,18],"h2",{"id":17},"what-are-http-request-nodes-used-for-in-node-red","What are HTTP request nodes used for in Node-RED",[20,21,22],"p",{},"In Node-RED, an HTTP Request node allows you to make HTTP requests to external servers or services. This allows you to interact with web services, APIs, or any other HTTP-based endpoints.",[20,24,25],{},"When you configure an HTTP Request node, you typically specify the method (GET, POST, PUT, DELETE, among others), the URL of the endpoint you want to communicate with, any headers you need to include, and the payload if applicable. Once configured, this node will send the HTTP request when triggered by an incoming message or event.",[15,27,29],{"id":28},"configuring-http-request-node","Configuring HTTP Request node",[20,31,32],{},"Below, you'll find a range of settings to tailor HTTP requests to fit the needs of different APIs or web services. Depending on the service you're working with, some options might be crucial, while others could be optional.",[34,35,36,49,85,114,125,181,187,198,204,210,236],"ul",{},[37,38,39,43,44,48],"li",{},[40,41,42],"strong",{},"Method:"," Select the HTTP method for the request (e.g., GET, POST, PUT, DELETE). You can dynamically set it using ",[45,46,47],"code",{},"msg.method",".",[37,50,51,54,55,58,59,62,63,66,67,70,71,73,74,77,78,81,82,48],{},[40,52,53],{},"URL:"," Specify the endpoint URL to communicate with. Dynamic URL setting is allowed using ",[45,56,57],{},"msg.url",". additionally, if you want to construct a URL with the message's property you can utilize Mustache-style tags with double braces ",[45,60,61],{},"{{ }}",". For example, ",[45,64,65],{},"example.com\u002F{{topic}}",", where the value of ",[45,68,69],{},"msg.topic"," will be automatically inserted. Using double braces ",[45,72,61],{}," performs HTML escaping by default, so special characters in the substituted value will be escaped. However, if you want to preserve special characters like ",[45,75,76],{},"\u002F"," and ",[45,79,80],{},"&"," in the constructed URL, you can use triple braces ",[45,83,84],{},"{{{ }}}",[37,86,87,90,91],{},[40,88,89],{},"Payload:"," Allows to choose how received payload from the previous node will be sent with the request:\n",[34,92,93,99,108],{},[37,94,95,98],{},[40,96,97],{},"Ignore:"," If enabled Payload will be ignored.",[37,100,101,104,105,48],{},[40,102,103],{},"Append to query-string parameter:"," Enabling this option will Allow sending URL query string parameters using ",[45,106,107],{},"msg.payload",[37,109,110,113],{},[40,111,112],{},"Send as request:"," Send payload data as part of the request body.",[37,115,116,119,120,48],{},[40,117,118],{},"Enable Secure Connection:"," Allows to activate SSL\u002FTLS for secure communication. TLS configuration options are available, For more information refer to ",[121,122,124],"a",{"href":123},"\u002Fnode-red\u002Fcore-nodes\u002Ftls","TLS config node",[37,126,127,130,131],{},[40,128,129],{},"Use Authentication:"," If required, allow to provide credentials for authentication.\n",[34,132,133],{},[37,134,135,138,139],{},[40,136,137],{},"Type:"," Select the authentication type.\n",[34,140,141,161,167],{},[37,142,143,146,147],{},[40,144,145],{},"basic:"," Uses Basic authentication where the username and password are sent in the request headers in Base64-encoded form.\n",[34,148,149,155],{},[37,150,151,154],{},[40,152,153],{},"Username:"," Provide the username for authentication.",[37,156,157,160],{},[40,158,159],{},"Password:"," Provide the password for authentication.",[37,162,163,166],{},[40,164,165],{},"digest:"," Uses Digest authentication, which is more secure than Basic authentication as it sends hashed passwords rather than plaintext.",[37,168,169,172,173],{},[40,170,171],{},"bearer:"," Uses Bearer token authentication where a bearer token, typically a JSON Web Token (JWT), is sent in the Authorization header.\n",[34,174,175],{},[37,176,177,180],{},[40,178,179],{},"Token:"," Provide the bearer token if bearer authentication is selected.",[37,182,183,186],{},[40,184,185],{},"Enable Connection Keep-Alive:"," Enabling this option will allow Maintain persistent connections for efficiency.",[37,188,189,192,193,197],{},[40,190,191],{},"Use Proxy:"," Allows to Route requests through a proxy server if necessary, for more information on the configuration of ",[121,194,196],{"href":195},"\u002Fnode-red\u002Fcore-nodes\u002Fhttp-proxy\u002F","HTTP Proxy"," config node",[37,199,200,203],{},[40,201,202],{},"Only send non-2xx responses to Catch node:"," Enabling this option will send only non-success responses to the Catch node.",[37,205,206,209],{},[40,207,208],{},"Disable Strict HTTP Parsing:"," Enabling this option relaxes how Node-RED interprets HTTP responses. It's handy when dealing with responses that don't perfectly match the standard HTTP format.",[37,211,212,215,216],{},[40,213,214],{},"Return:"," Allows to Choose the format for response data conversion\n",[34,217,218,224,230],{},[37,219,220,223],{},[40,221,222],{},"A UTF-8 string:"," Return response data as a UTF-8 string.",[37,225,226,229],{},[40,227,228],{},"A binary buffer:"," Return response data as a binary buffer.",[37,231,232,235],{},[40,233,234],{},"A parsed JSON object:"," Parse response data as JSON and return the object.",[37,237,238,241,242,245,246,248,249,251,252,255,256,48],{},[40,239,240],{},"Headers:"," Allows to  Add headers to the HTTP request such as content-type, accept, user agent, etc. You can dynamically set headers using ",[45,243,244],{},"msg.headers",". However Reset ",[45,247,244],{}," to avoid unintended header inheritance when using multiple HTTP request nodes in the same flow. Moreover, If ",[45,250,107],{}," is an Object, the node automatically sets the ",[45,253,254],{},"Content-Type"," to ",[45,257,258],{},"application\u002Fjson",[15,260,262],{"id":261},"usecase","Usecase",[264,265,266,272,282],"ol",{},[37,267,268,271],{},[40,269,270],{},"API Integration:"," The HTTP request node allows seamless integration with external APIs. Developers can utilize it to fetch data from APIs using GET requests or send data to APIs using POST\u002FPUT requests. For instance, fetching weather data from a weather API or posting data to a messaging service like Slack are common scenarios.",[37,273,274,277,278],{},[40,275,276],{},"Webhooks:"," With the HTTP request node, users can set up webhooks to trigger actions in response to specific events. This enables real-time communication between different applications. For example, triggering a webhook to notify a third-party service when certain conditions are met or when data is received from a sensor. For more information, refer to ",[121,279,281],{"href":280},"\u002Fnode-red\u002Fintegration-technologies\u002Fwebhook\u002F","Using webhook with Node-RED",[37,283,284,287],{},[40,285,286],{},"Remote Control and Device Management:"," In smart home systems, the HTTP request node can be used to facilitates remote device management. It allows users to control various devices such as lights, thermostats, and security cameras via web or mobile interfaces by interacting with device APIs. Actions like toggling devices, adjusting settings, and receiving real-time updates can be achieved through the HTTP request node.",[20,289,290],{},"These are a few use cases of the HTTP Request node, but its ability to communicate with other services is a significant and core capability. This capability alone opens the door to a diverse array of different use cases.",[15,292,294],{"id":293},"examples","Examples",[264,296,297],{},[37,298,299],{},"Below is an example showing how you can construct a URL with message properties in the HTTP request node, an example includes sending a GET request.",[301,302],"render-flow",{":height":303,"flow":304},"200","W3siaWQiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwidHlwZSI6InRhYiIsImxhYmVsIjoiRmxvdyAxIiwiZGlzYWJsZWQiOmZhbHNlLCJpbmZvIjoiIiwiZW52IjpbXX0seyJpZCI6ImRjZTQwN2JjY2U5NjM1NjciLCJ0eXBlIjoiaW5qZWN0IiwieiI6ImIxNTJhOTE0NjUzZDlmY2UiLCJuYW1lIjoiR2V0IHBvc3QgIiwicHJvcHMiOlt7InAiOiJ0b3BpYyIsInYiOiIxIiwidnQiOiJudW0ifV0sInJlcGVhdCI6IiIsImNyb250YWIiOiIiLCJvbmNlIjpmYWxzZSwib25jZURlbGF5IjowLjEsInRvcGljIjoiIiwieCI6MjAwLCJ5IjoyMjAsIndpcmVzIjpbWyJlYTkxNzY5Mzg2Y2E3YjQ4Il1dfSx7ImlkIjoiZWE5MTc2OTM4NmNhN2I0OCIsInR5cGUiOiJodHRwIHJlcXVlc3QiLCJ6IjoiYjE1MmE5MTQ2NTNkOWZjZSIsIm5hbWUiOiIiLCJtZXRob2QiOiJHRVQiLCJyZXQiOiJvYmoiLCJwYXl0b3FzIjoiaWdub3JlIiwidXJsIjoiaHR0cHM6Ly9qc29ucGxhY2Vob2xkZXIudHlwaWNvZGUuY29tL3Bvc3RzL3t7dG9waWN9fSIsInRscyI6IiIsInBlcnNpc3QiOmZhbHNlLCJwcm94eSI6IiIsImluc2VjdXJlSFRUUFBhcnNlciI6ZmFsc2UsImF1dGhUeXBlIjoiIiwic2VuZGVyciI6ZmFsc2UsImhlYWRlcnMiOltdLCJ4Ijo0OTAsInkiOjIyMCwid2lyZXMiOltbIjJmNTk3MDQ3NjYzZTI5NjQiXV19LHsiaWQiOiIyZjU5NzA0NzY2M2UyOTY0IiwidHlwZSI6ImRlYnVnIiwieiI6ImIxNTJhOTE0NjUzZDlmY2UiLCJuYW1lIjoiZGVidWcgMSIsImFjdGl2ZSI6dHJ1ZSwidG9zaWRlYmFyIjp0cnVlLCJjb25zb2xlIjpmYWxzZSwidG9zdGF0dXMiOmZhbHNlLCJjb21wbGV0ZSI6ImZhbHNlIiwic3RhdHVzVmFsIjoiIiwic3RhdHVzVHlwZSI6ImF1dG8iLCJ4Ijo3NDAsInkiOjIyMCwid2lyZXMiOltdfSx7ImlkIjoiOWY0MDUwOWI2NjQyZDA4MiIsInR5cGUiOiJjb21tZW50IiwieiI6ImIxNTJhOTE0NjUzZDlmY2UiLCJuYW1lIjoiVGhlIEhUVFAgcmVxdWVzdCBub2RlIHJldHJpZXZlcyBwb3N0cyBmcm9tIGEgbW9jayBBUEkgdXNpbmcgdGhlIElEIHBhc3NlZCBhcyBhIHF1ZXJ5IHBhcmFtZXRlciB3aXRoIGBtc2cudG9waWNgIGJ5IHRoZSBpbmplY3Qgbm9kZS4iLCJpbmZvIjoiIiwieCI6NTEwLCJ5IjoxNDAsIndpcmVzIjpbXX1d",[264,306,308],{"start":307},2,[37,309,310],{},"Below is an example showing how you can send an HTTP POST request to a mock API. This example includes registering a user.",[301,312],{":height":303,"flow":313},"W3siaWQiOiJkY2U0MDdiY2NlOTYzNTY3IiwidHlwZSI6ImluamVjdCIsInoiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwibmFtZSI6IlJlZ2lzdGVyIFdpdGggTW9jayBBUEkiLCJwcm9wcyI6W3sicCI6InBheWxvYWQuZW1haWwiLCJ2IjoiZXZlLmhvbHRAcmVxcmVzLmluIiwidnQiOiJzdHIifSx7InAiOiJwYXlsb2FkLnBhc3N3b3JkIiwidiI6InBhc3N3b3JkIiwidnQiOiJzdHIifV0sInJlcGVhdCI6IiIsImNyb250YWIiOiIiLCJvbmNlIjpmYWxzZSwib25jZURlbGF5IjowLjEsInRvcGljIjoiIiwieCI6MjIwLCJ5IjoyMjAsIndpcmVzIjpbWyJlYTkxNzY5Mzg2Y2E3YjQ4Il1dfSx7ImlkIjoiZWE5MTc2OTM4NmNhN2I0OCIsInR5cGUiOiJodHRwIHJlcXVlc3QiLCJ6IjoiYjE1MmE5MTQ2NTNkOWZjZSIsIm5hbWUiOiIiLCJtZXRob2QiOiJQT1NUIiwicmV0IjoidHh0IiwicGF5dG9xcyI6Imlnbm9yZSIsInVybCI6Imh0dHBzOi8vcmVxcmVzLmluL2FwaS9sb2dpbiIsInRscyI6IiIsInBlcnNpc3QiOmZhbHNlLCJwcm94eSI6IiIsImluc2VjdXJlSFRUUFBhcnNlciI6ZmFsc2UsImF1dGhUeXBlIjoiIiwic2VuZGVyciI6ZmFsc2UsImhlYWRlcnMiOltdLCJ4Ijo0OTAsInkiOjIyMCwid2lyZXMiOltbIjJmNTk3MDQ3NjYzZTI5NjQiXV19LHsiaWQiOiIyZjU5NzA0NzY2M2UyOTY0IiwidHlwZSI6ImRlYnVnIiwieiI6ImIxNTJhOTE0NjUzZDlmY2UiLCJuYW1lIjoiZGVidWcgMSIsImFjdGl2ZSI6dHJ1ZSwidG9zaWRlYmFyIjp0cnVlLCJjb25zb2xlIjpmYWxzZSwidG9zdGF0dXMiOmZhbHNlLCJjb21wbGV0ZSI6ImZhbHNlIiwic3RhdHVzVmFsIjoiIiwic3RhdHVzVHlwZSI6ImF1dG8iLCJ4Ijo3NDAsInkiOjIyMCwid2lyZXMiOltdfSx7ImlkIjoiOWY0MDUwOWI2NjQyZDA4MiIsInR5cGUiOiJjb21tZW50IiwieiI6ImIxNTJhOTE0NjUzZDlmY2UiLCJuYW1lIjoiVGhlIEhUVFAgcmVxdWVzdCBub2RlIHNlbmRzIGEgUE9TVCByZXF1ZXN0IHRvIHJlZ2lzdGVyIGEgdXNlci4iLCJpbmZvIjoiIiwieCI6NDMwLCJ5IjoxNDAsIndpcmVzIjpbXX1d",[264,315,317],{"start":316},3,[37,318,319],{},"Below is an example demonstrating how you can dynamically set the URL, method, and headers for the HTTP request node. Additionally, this example illustrates sending a GET request to a mock API with an authorization token.",[301,321],{":height":303,"flow":322},"W3siaWQiOiJkY2U0MDdiY2NlOTYzNTY3IiwidHlwZSI6ImluamVjdCIsInoiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwibmFtZSI6Im1ha2UgcmVxdWVzdCAiLCJwcm9wcyI6W3sicCI6InVybCIsInYiOiJodHRwczovL3Bvc3RtYW4tZWNoby5jb20vYmFzaWMtYXV0aCIsInZ0Ijoic3RyIn0seyJwIjoibWV0aG9kIiwidiI6IkdFVCIsInZ0Ijoic3RyIn0seyJwIjoiaGVhZGVycy5BdXRob3JpemF0aW9uIiwidiI6IkJhc2ljIGNHOXpkRzFoYmpwd1lYTnpkMjl5WkEiLCJ2dCI6InN0ciJ9XSwicmVwZWF0IjoiIiwiY3JvbnRhYiI6IiIsIm9uY2UiOmZhbHNlLCJvbmNlRGVsYXkiOjAuMSwidG9waWMiOiIiLCJ4IjoyMTAsInkiOjIyMCwid2lyZXMiOltbImVhOTE3NjkzODZjYTdiNDgiXV19LHsiaWQiOiJlYTkxNzY5Mzg2Y2E3YjQ4IiwidHlwZSI6Imh0dHAgcmVxdWVzdCIsInoiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwibmFtZSI6IiIsIm1ldGhvZCI6InVzZSIsInJldCI6Im9iaiIsInBheXRvcXMiOiJpZ25vcmUiLCJ1cmwiOiIiLCJ0bHMiOiIiLCJwZXJzaXN0IjpmYWxzZSwicHJveHkiOiIiLCJpbnNlY3VyZUhUVFBQYXJzZXIiOmZhbHNlLCJhdXRoVHlwZSI6IiIsInNlbmRlcnIiOmZhbHNlLCJoZWFkZXJzIjpbXSwieCI6NDkwLCJ5IjoyMjAsIndpcmVzIjpbWyIyZjU5NzA0NzY2M2UyOTY0Il1dfSx7ImlkIjoiMmY1OTcwNDc2NjNlMjk2NCIsInR5cGUiOiJkZWJ1ZyIsInoiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwibmFtZSI6ImRlYnVnIDEiLCJhY3RpdmUiOnRydWUsInRvc2lkZWJhciI6dHJ1ZSwiY29uc29sZSI6ZmFsc2UsInRvc3RhdHVzIjpmYWxzZSwiY29tcGxldGUiOiJ0cnVlIiwidGFyZ2V0VHlwZSI6ImZ1bGwiLCJzdGF0dXNWYWwiOiIiLCJzdGF0dXNUeXBlIjoiYXV0byIsIngiOjc0MCwieSI6MjIwLCJ3aXJlcyI6W119LHsiaWQiOiI5ZjQwNTA5YjY2NDJkMDgyIiwidHlwZSI6ImNvbW1lbnQiLCJ6IjoiYjE1MmE5MTQ2NTNkOWZjZSIsIm5hbWUiOiJUaGUgSFRUUCByZXF1ZXN0IG5vZGUgcmV0cmlldmVzIHBvc3RzIGZyb20gYSBtb2NrIEFQSSB1c2luZyB0aGUgSUQgcGFzc2VkIGFzIGEgcXVlcnkgcGFyYW1ldGVyIHdpdGggYG1zZy50b3BpY2AgYnkgdGhlIGluamVjdCBub2RlLiIsImluZm8iOiIiLCJ4Ijo1MTAsInkiOjE0MCwid2lyZXMiOltdfV0=",[264,324,326],{"start":325},4,[37,327,328],{},"Below is an example showing how you can send a PUT request using the HTTP request node.",[301,330],{":height":303,"flow":331},"W3siaWQiOiJkY2U0MDdiY2NlOTYzNTY3IiwidHlwZSI6ImluamVjdCIsInoiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwibmFtZSI6IlVwZGF0ZSBwb3N0IiwicHJvcHMiOlt7InAiOiJwYXlsb2FkIn1dLCJyZXBlYXQiOiIiLCJjcm9udGFiIjoiIiwib25jZSI6ZmFsc2UsIm9uY2VEZWxheSI6MC4xLCJ0b3BpYyI6IiIsInBheWxvYWQiOiJ7XCJpZFwiOjEsXCJ0aXRsZVwiOlwiZm9vXCIsXCJib2R5XCI6XCJiYXJcIixcInVzZXJJZFwiOjF9IiwicGF5bG9hZFR5cGUiOiJqc29uIiwieCI6MjEwLCJ5IjoyMjAsIndpcmVzIjpbWyJlYTkxNzY5Mzg2Y2E3YjQ4Il1dfSx7ImlkIjoiZWE5MTc2OTM4NmNhN2I0OCIsInR5cGUiOiJodHRwIHJlcXVlc3QiLCJ6IjoiYjE1MmE5MTQ2NTNkOWZjZSIsIm5hbWUiOiIiLCJtZXRob2QiOiJQVVQiLCJyZXQiOiJvYmoiLCJwYXl0b3FzIjoiaWdub3JlIiwidXJsIjoiaHR0cHM6Ly9qc29ucGxhY2Vob2xkZXIudHlwaWNvZGUuY29tL3Bvc3RzLzEiLCJ0bHMiOiIiLCJwZXJzaXN0IjpmYWxzZSwicHJveHkiOiIiLCJpbnNlY3VyZUhUVFBQYXJzZXIiOmZhbHNlLCJhdXRoVHlwZSI6IiIsInNlbmRlcnIiOmZhbHNlLCJoZWFkZXJzIjpbXSwieCI6NDkwLCJ5IjoyMjAsIndpcmVzIjpbWyIyZjU5NzA0NzY2M2UyOTY0Il1dfSx7ImlkIjoiMmY1OTcwNDc2NjNlMjk2NCIsInR5cGUiOiJkZWJ1ZyIsInoiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwibmFtZSI6ImRlYnVnIDEiLCJhY3RpdmUiOnRydWUsInRvc2lkZWJhciI6dHJ1ZSwiY29uc29sZSI6ZmFsc2UsInRvc3RhdHVzIjpmYWxzZSwiY29tcGxldGUiOiJ0cnVlIiwidGFyZ2V0VHlwZSI6ImZ1bGwiLCJzdGF0dXNWYWwiOiIiLCJzdGF0dXNUeXBlIjoiYXV0byIsIngiOjc0MCwieSI6MjIwLCJ3aXJlcyI6W119LHsiaWQiOiI5ZjQwNTA5YjY2NDJkMDgyIiwidHlwZSI6ImNvbW1lbnQiLCJ6IjoiYjE1MmE5MTQ2NTNkOWZjZSIsIm5hbWUiOiJUaGUgSFRUUCByZXF1ZXN0IG5vZGUgc2VuZHMgYSBQVVQgcmVxdWVzdCB0byB1cGRhdGUgdGhlIHBvc3QuIiwiaW5mbyI6IiIsIngiOjQ3MCwieSI6MTQwLCJ3aXJlcyI6W119XQ==",[264,333,335],{"start":334},5,[37,336,337],{},"Below is an example showing how you can send a DELETE request using the HTTP request node.",[301,339],{":height":303,"flow":340},"W3siaWQiOiJkY2U0MDdiY2NlOTYzNTY3IiwidHlwZSI6ImluamVjdCIsInoiOiJiMTUyYTkxNDY1M2Q5ZmNlIiwibmFtZSI6ImRlbGV0ZSBwb3N0IiwicHJvcHMiOlt7InAiOiJwYXlsb2FkIn1dLCJyZXBlYXQiOiIiLCJjcm9udGFiIjoiIiwib25jZSI6ZmFsc2UsIm9uY2VEZWxheSI6MC4xLCJ0b3BpYyI6IiIsInBheWxvYWQiOiIiLCJwYXlsb2FkVHlwZSI6InN0ciIsIngiOjIwMCwieSI6MjIwLCJ3aXJlcyI6W1siZWE5MTc2OTM4NmNhN2I0OCJdXX0seyJpZCI6ImVhOTE3NjkzODZjYTdiNDgiLCJ0eXBlIjoiaHR0cCByZXF1ZXN0IiwieiI6ImIxNTJhOTE0NjUzZDlmY2UiLCJuYW1lIjoiIiwibWV0aG9kIjoiREVMRVRFIiwicmV0Ijoib2JqIiwicGF5dG9xcyI6Imlnbm9yZSIsInVybCI6Imh0dHBzOi8vanNvbnBsYWNlaG9sZGVyLnR5cGljb2RlLmNvbS9wb3N0cy8xIiwidGxzIjoiIiwicGVyc2lzdCI6ZmFsc2UsInByb3h5IjoiIiwiaW5zZWN1cmVIVFRQUGFyc2VyIjpmYWxzZSwiYXV0aFR5cGUiOiIiLCJzZW5kZXJyIjpmYWxzZSwiaGVhZGVycyI6W10sIngiOjQ5MCwieSI6MjIwLCJ3aXJlcyI6W1siMmY1OTcwNDc2NjNlMjk2NCJdXX0seyJpZCI6IjJmNTk3MDQ3NjYzZTI5NjQiLCJ0eXBlIjoiZGVidWciLCJ6IjoiYjE1MmE5MTQ2NTNkOWZjZSIsIm5hbWUiOiJkZWJ1ZyAxIiwiYWN0aXZlIjp0cnVlLCJ0b3NpZGViYXIiOnRydWUsImNvbnNvbGUiOmZhbHNlLCJ0b3N0YXR1cyI6ZmFsc2UsImNvbXBsZXRlIjoidHJ1ZSIsInRhcmdldFR5cGUiOiJmdWxsIiwic3RhdHVzVmFsIjoiIiwic3RhdHVzVHlwZSI6ImF1dG8iLCJ4Ijo3NDAsInkiOjIyMCwid2lyZXMiOltdfSx7ImlkIjoiOWY0MDUwOWI2NjQyZDA4MiIsInR5cGUiOiJjb21tZW50IiwieiI6ImIxNTJhOTE0NjUzZDlmY2UiLCJuYW1lIjoiVGhlIEhUVFAgcmVxdWVzdCBub2RlIHNlbmRzIGEgREVMRVRFIHJlcXVlc3QgdG8gZGVsZXRlIGEgcG9zdC4iLCJpbmZvIjoiIiwieCI6NDQwLCJ5IjoxNDAsIndpcmVzIjpbXX1d",[15,342,344],{"id":343},"output","Output",[34,346,347,353,359,365,371,377],{},[37,348,349,352],{},[40,350,351],{},"payload:"," The body of the response can be returned as a string, parsed JSON object, or a binary buffer.",[37,354,355,358],{},[40,356,357],{},"statusCode:"," Indicates the status code of the response or the error code if the request couldn't be completed.",[37,360,361,364],{},[40,362,363],{},"headers:"," An object containing the response headers.",[37,366,367,370],{},[40,368,369],{},"responseURL:"," Provides the final redirected URL if any redirects occurred during processing; otherwise, it shows the URL of the original request.",[37,372,373,376],{},[40,374,375],{},"responseCookies:"," If the response includes cookies, this property is an object containing name\u002Fvalue pairs for each cookie.",[37,378,379,382,383,386],{},[40,380,381],{},"redirectList:"," Accumulated information about redirects, including the next redirect destination (",[45,384,385],{},"location",") and cookies returned from the redirect source.",[15,388,390],{"id":389},"node-documentation","Node Documentation",[392,393,396,399,400,399,405,399,518,399,522,399,581,399,585,399,601,399,610,399,621,399,626,642,646,657,663,667,676,686,690,702,708],"div",{"className":394},[395],"core-node-doc",[20,397,398],{},"Sends HTTP requests and returns the response."," ",[401,402,404],"h3",{"id":403},"inputs","Inputs",[406,407,410,422,426,433,453,461,466,473,476,480,483,487,494,498,507,511],"dl",{"className":408},[409],"message-properties",[411,412,415,416],"dt",{"className":413},[414],"optional","url ",[417,418,421],"span",{"className":419},[420],"property-type","string",[423,424,425],"dd",{},"If not configured in the node, this optional property sets the url of the request.",[411,427,429,430],{"className":428},[414],"method ",[417,431,421],{"className":432},[420],[423,434,435,436,439,440,439,443,439,446,449,450,48],{},"If not configured in the node, this optional property sets the HTTP method of the request.\nMust be one of ",[45,437,438],{},"GET",", ",[45,441,442],{},"PUT",[45,444,445],{},"POST",[45,447,448],{},"PATCH"," or ",[45,451,452],{},"DELETE",[411,454,456,457],{"className":455},[414],"headers ",[417,458,460],{"className":459},[420],"object",[423,462,463,464,399],{},"Sets the HTTP headers of the request. NOTE: Any headers set in the node configuration will overwrite any matching headers in ",[45,465,244],{},[411,467,469,470],{"className":468},[414],"cookies ",[417,471,460],{"className":472},[420],[423,474,475],{},"If set, can be used to send cookies with the request.",[411,477,479],{"className":478},[414],"payload",[423,481,482],{},"Sent as the body of the request.",[411,484,486],{"className":485},[414],"rejectUnauthorized",[423,488,489,490,493],{},"If set to ",[45,491,492],{},"false",", allows requests to be made to https sites that use\nself signed certificates.",[411,495,497],{"className":496},[414],"followRedirects",[423,499,489,500,502,503,506],{},[45,501,492],{}," prevent following Redirect (HTTP 301).",[45,504,505],{},"true"," by default",[411,508,510],{"className":509},[414],"requestTimeout",[423,512,513,514,517],{},"If set to a positive number of milliseconds, will override the globally set ",[45,515,516],{},"httpRequestTimeout"," parameter.",[401,519,521],{"id":520},"outputs","Outputs",[406,523,525,532,535,542,545,550,553,559,562,568,571,578],{"className":524},[409],[411,526,527,528],{},"payload ",[417,529,531],{"className":530},[420],"string | object | buffer",[423,533,534],{},"The body of the response. The node can be configured to return the body\nas a string, attempt to parse it as a JSON string or leave it as a\nbinary buffer.",[411,536,537,538],{},"statusCode ",[417,539,541],{"className":540},[420],"number",[423,543,544],{},"The status code of the response, or the error code if the request could not be completed.",[411,546,456,547],{},[417,548,460],{"className":549},[420],[423,551,552],{},"An object containing the response headers.",[411,554,555,556],{},"responseUrl ",[417,557,421],{"className":558},[420],[423,560,561],{},"In case any redirects occurred while processing the request, this property is the final redirected url.\nOtherwise, the url of the original request.",[411,563,564,565],{},"responseCookies ",[417,566,460],{"className":567},[420],[423,569,570],{},"If the response includes cookies, this property is an object of name\u002Fvalue pairs for each cookie.",[411,572,573,574],{},"redirectList ",[417,575,577],{"className":576},[420],"array",[423,579,580],{},"If the request was redirected one or more times, the accumulated information will be added to this property. `location` is the next redirect destination. `cookies` is the cookies returned from the redirect source.",[401,582,584],{"id":583},"details","Details",[20,586,587,588,593,594,597,598,600],{},"When configured within the node, the URL property can contain ",[121,589,592],{"href":590,"target":591},"http:\u002F\u002Fmustache.github.io\u002Fmustache.5.html","_blank","mustache-style"," tags. These allow the\nurl to be constructed using values of the incoming message. For example, if the url is set to\n",[45,595,596],{},"example.com\u002F{{{topic}}}",", it will have the value of ",[45,599,69],{}," automatically inserted.\nUsing {{{...}}} prevents mustache from escaping characters like \u002F & etc.",[20,602,603,604,606,607,609],{},"The node can optionally automatically encode ",[45,605,107],{}," as query string parameters for a GET request, in which case ",[45,608,107],{}," has to be an object.",[20,611,612,616,617,620],{},[613,614,615],"b",{},"Note",": If running behind a proxy, the standard ",[45,618,619],{},"http_proxy=..."," environment variable should be set and Node-RED restarted, or use Proxy Configuration. If Proxy Configuration was set, the configuration take precedence over environment variable.",[622,623,625],"h4",{"id":624},"using-multiple-http-request-nodes","Using multiple HTTP Request nodes",[20,627,628,629,631,632,634,635,637,638,641],{},"In order to use more than one of these nodes in the same flow, care must be taken with\nthe ",[45,630,244],{}," property. The first node will set this property with\nthe response headers. The next node will then use those headers for its request - this\nis not usually the right thing to do. If ",[45,633,244],{}," property is left unchanged\nbetween nodes, it will be ignored by the second node. To set custom headers, ",[45,636,244],{},"\nshould first be deleted or reset to an empty object: ",[45,639,640],{},"{}",".\n",[622,643,645],{"id":644},"cookie-handling","Cookie handling",[20,647,648,649,652,653,656],{},"The ",[45,650,651],{},"cookies"," property passed to the node must be an object of name\u002Fvalue pairs.\nThe value can be either a string to set the value of the cookie or it can be an\nobject with a single ",[45,654,655],{},"value"," property.",[20,658,659,660,656],{},"Any cookies returned by the request are passed back under the ",[45,661,662],{},"responseCookies",[622,664,666],{"id":665},"content-type-handling","Content type handling",[20,668,669,670,672,673,675],{},"If ",[45,671,107],{}," is an Object, the node will automatically set the content type\nof the request to ",[45,674,258],{}," and encode the body as such.",[20,677,678,679,682,683,48],{},"To encode the request as form data, ",[45,680,681],{},"msg.headers[\"content-type\"]"," should be set to ",[45,684,685],{},"application\u002Fx-www-form-urlencoded",[622,687,689],{"id":688},"file-upload","File Upload",[20,691,692,693,682,695,698,699,701],{},"To perform a file upload, ",[45,694,681],{},[45,696,697],{},"multipart\u002Fform-data","\nand the ",[45,700,107],{}," passed to the node must be an object with the following structure:",[703,704,705],"pre",{},[45,706,707],{},"{\n\"KEY\": {\n\"value\": FILE_CONTENTS,\n\"options\": {\n\"filename\": \"FILENAME\"\n}\n}\n}",[20,709,710,711,439,714,77,717,720],{},"The values of ",[45,712,713],{},"KEY",[45,715,716],{},"FILE_CONTENTS",[45,718,719],{},"FILENAME","\nshould be set to the appropriate values.",{"title":722,"searchDepth":307,"depth":307,"links":723},"",[724,725,726,727,728,729],{"id":17,"depth":307,"text":18},{"id":28,"depth":307,"text":29},{"id":261,"depth":307,"text":262},{"id":293,"depth":307,"text":294},{"id":343,"depth":307,"text":344},{"id":389,"depth":307,"text":390,"children":730},[731,732,733],{"id":403,"depth":316,"text":404},{"id":520,"depth":316,"text":521},{"id":583,"depth":316,"text":584},"md",{},true,"\u002Fnode-red\u002Fcore-nodes\u002Fhttp-request",{"title":5,"description":722},"node-red\u002Fcore-nodes\u002Fhttp-request","GgjIGbbBaJ4ZBnsBcteZXkZx9_hsV5RD924WYhlHjg8",1780070555931]