<doc>
	<legacy_id>1391</legacy_id>
	<name>httpHeaders</name>
	<type>property</type>

	<syntax>
		<example>set the httpHeaders to <i>headersList</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies custom headers to be sent with each GET, POST or PUT request to an <keyword tag="http">HTTP</keyword> <glossary tag="server">server</glossary>.  </summary>

	<examples>
<example>set the httpHeaders to field &quot;Headers&quot; &amp; return &amp; field &quot;Special&quot;</example>
	</examples>

	<history>
		<introduced version="1.0">Added.  </introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
	</history>

	<objects>
		<global/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	  <ios/>
    <android/>
  </platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
	  <mobile/>
  </classes>

	<security>
	</security>


	<classification>
		<category>Networks &amp; Communication</category>
	</classification>

	<references>
		<function tag="URLDecode">URLDecode Function</function>
		<function tag="libURLLastRHHeaders">libURLLastRHHeaders Function</function>
		<command tag="post">post Command</command>
		<command tag="libURLSetCustomHTTPHeaders">libURLSetCustomHTTPHeaders Command</command>
	</references>

	<description>
	<overview>Use the <b>httpHeaders</b> <glossary tag="property">property</glossary> to supply custom headers when interacting with <keyword tag="http">HTTP</keyword> <glossary tag="server">servers</glossary> that require them.  </overview>

		<parameters>
		</parameters>

	<value>The <b>httpHeaders</b> is a <keyword tag="string">string</keyword>. <p></p><p>By default, the <b>httpHeaders</b> <glossary tag="property">property</glossary> is set to empty. </p></value>
	<comments>Whenever LiveCode contacts a web server to download a page (with the <b>load</b> <glossary tag="command">command</glossary> or by using a <keyword tag="URL">URL</keyword> in an <glossary tag="expression">expression</glossary>) or to post data (with the <command tag="post">post</command> <glossary tag="command">command</glossary>), the contents of the <b>httpHeaders</b> <glossary tag="property">property</glossary> is sent to the <glossary tag="web server">web server</glossary> along with the <keyword tag="default">default</keyword> headers.<p></p><p>The custom header lines specified by the <b>httpHeaders</b> are sent along with a set of <keyword tag="default">default</keyword> headers. If the <i>headersList</i> includes any header lines that are part of the <keyword tag="default">default</keyword> headers, the one in the <i>headersList</i> replaces the <keyword tag="default">default</keyword> header. Any new lines are appended to the end of the headers to be sent to the server. </p><p></p><p>To replace the default headers instead of adding to them, use the <b>libURLSetCustomHTTPHeaders</b> <glossary tag="command">command</glossary> instead. </p><p></p><p></p><important>If you have used the <command tag="libURLSetCustomHTTPHeaders">libURLSetCustomHTTPHeaders</command> <glossary tag="command">command</glossary> to set all the headers, the <b>httpHeaders</b> setting is ignored and the headers set by <command tag="libURLSetCustomHTTPHeaders">libURLSetCustomHTTPHeaders</command> are used instead. </important><p></p><p>For technical information about the standard headers recognized in the HTTP 1.1 protocol, see RFC 2616 at &lt;<u>http://www. ietf. org/rfc/rfc2616. txt</u>&gt;. </p></comments>
	</description>
</doc>