object-api/v1/section_object-api-browser-...

29 lines
1.6 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="content-disposition">
<title>Use the Content-Disposition metadata</title>
<para>To override the default behavior for a browser, use the
<literal>Content-Disposition</literal> header to specify
the override behavior and assign this header to an object. For
example, this header might specify that the browser use a
download program to save this file rather than show the file,
which is the default.</para>
<example>
<title>Override browser default behavior request: HTTP</title>
<para>This example assigns an attachment type to the
<literal>Content-Disposition</literal> header. This
attachment type indicates that the file is to be
downloaded as <literal>goodbye.txt</literal>:</para>
<screen><prompt>#</prompt> <userinput>curl -i $publicURL/marktwain/goodbye -X POST -H "X-Auth-Token: $token" -H "Content-Length: 14" -H "Content-Type: application/octet-stream" -H "Content-Disposition: attachment; filename=goodbye.txt"</userinput></screen>
<screen><computeroutput>HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txa9b5e57d7f354d7ea9f57-0052e17e13
Date: Thu, 23 Jan 2014 20:39:47 GMT
&lt;html>&lt;h1>Accepted&lt;/h1>&lt;p>The request is accepted for processing.&lt;/p>&lt;/html></computeroutput></screen>
</example>
</section>