Sample code for 30+ languages & platforms
Unicode C

How to Access Parts of a multipart/related HTTP Response

See more HTTP Examples

Demonstrates how to access the parts of a multipart/related response. This example sends a ficticious multipart/related request, and handles a ficticious multipart/related response.

We send the following multipart/related request:

Content-Type: multipart/related; start-info="text/xml"; type="application/xop+xml"; boundary="----=_Part_0_1744155.1118953559416"
Content-Length: 3453
SOAPAction: "some-SOAP-action"

------=_Part_1_4558657.1118953559446
Content-Type: application/xop+xml; type="text/xml"; charset=utf-8

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Detail xmlns="http://example.org/mtom/data">
      <image>
        <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:5aeaa450-17f0-4484-b845-a8480c363444@example.org" />
      </image>
    </Detail>
  </soap:Body>
</soap:Envelope>

------=_Part_1_4558657.1118953559446
Content-Type: image/jpeg
Content-ID: <5aeaa450-17f0-4484-b845-a8480c363444@example.org>


... binary data ...

Chilkat Unicode C Downloads

Unicode C
#include <C_CkHttpW.h>
#include <C_CkXmlW.h>
#include <C_CkHttpRequestW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkMimeW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkXmlW soapXml;
    const wchar_t *xmlBody;
    HCkHttpRequestW req;
    BOOL useTls;
    HCkHttpResponseW resp;
    HCkMimeW mime;
    HCkMimeW part0;
    const wchar_t *subPartXmlBody;

    success = FALSE;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    http = CkHttpW_Create();

    soapXml = CkXmlW_Create();

    // Build the following SOAP XML

    // <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    //   <soap:Body>
    //     <Detail xmlns="http://example.org/mtom/data">
    //       <image>
    //         <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:5aeaa450-17f0-4484-b845-a8480c363444@example.org" />
    //       </image>
    //     </Detail>
    //   </soap:Body>
    // </soap:Envelope>

    CkXmlW_putTag(soapXml,L"soap:Envelope");
    CkXmlW_AddAttribute(soapXml,L"xmlns:soap",L"http://schemas.xmlsoap.org/soap/envelope/");
    CkXmlW_UpdateAttrAt(soapXml,L"soap:Body|Detail",TRUE,L"xmlns",L"http://example.org/mtom/data");
    CkXmlW_UpdateAttrAt(soapXml,L"soap:Body|Detail|image|xop:Include",TRUE,L"xmlns:xop",L"http://www.w3.org/2004/08/xop/include");
    CkXmlW_UpdateAttrAt(soapXml,L"soap:Body|Detail|image|xop:Include",TRUE,L"href",L"cid:5aeaa450-17f0-4484-b845-a8480c363444@example.org");

    CkXmlW_putEmitXmlDecl(soapXml,FALSE);
    xmlBody = CkXmlW_getXml(soapXml);
    wprintf(L"%s\n",xmlBody);

    req = CkHttpRequestW_Create();
    CkHttpRequestW_putHttpVerb(req,L"POST");
    CkHttpRequestW_putPath(req,L"/something/someTarget");

    CkHttpRequestW_putContentType(req,L"multipart/related; start-info=\"text/xml\"; type=\"application/xop+xml\"");
    CkHttpRequestW_AddHeader(req,L"SOAPAction",L"some-SOAP-action");

    success = CkHttpRequestW_AddStringForUpload2(req,L"",L"",xmlBody,L"utf-8",L"application/xop+xml; type=\"text/xml\"; charset=utf-8");

    // The bytes will be sent as binary (not base64 encoded).
    success = CkHttpRequestW_AddFileForUpload2(req,L"",L"qa_data/jpg/starfish.jpg",L"image/jpeg");

    // The JPEG data is the 2nd sub-part, and therefore is at index 1 (the first sub-part is at index 0)
    success = CkHttpRequestW_AddSubHeader(req,1,L"Content-ID",L"<5aeaa450-17f0-4484-b845-a8480c363444@example.org>");

    CkHttpW_putFollowRedirects(http,TRUE);

    useTls = TRUE;
    resp = CkHttpResponseW_Create();
    success = CkHttpW_HttpSReq(http,L"www.example.org",443,useTls,req,resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkXmlW_Dispose(soapXml);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    // Imagine the HTTP response is multipart related and is something like this:

    // HTTP/1.1 200 OK
    // Cache-Control: no-cache, no-store
    // Pragma: no-cache
    // Transfer-Encoding: chunked
    // Content-Type: multipart/related; boundary=------------080001080500020607080905
    // Expires: -1
    // Server: Microsoft-IIS/10.0
    // X-AspNet-Version: 4.0.30319
    // X-Powered-By: ASP.NET
    // Date: Wed, 19 Feb 2020 15:27:06 GMT
    // 
    // --------------080001080500020607080905
    // Content-Type: application/xop+xml; charset=iso-8859-1
    // Content-Id: RootPart
    // Content-Transfer-Encoding: binary
    // 
    // <?xml version="1.0" encoding="iso-8859-1"?>
    // <soapenv:Envelope xmlns:xcpt="...">
    //   <soapenv:Header />
    //   <soapenv:Body>
    //     <xres:Transport profile="http://something.example.com/..." version="1.4">
    //       <xres:TransportHeader>
    // 	...
    // 	...
    //       </xres:TransportHeader>
    //       <xres:TransportBody />
    //     </xres:Transport>
    //   </soapenv:Body>
    // </soapenv:Envelope>
    // --------------080001080500020607080905--

    // To get the XML, load the full MIME of the response into a Chilkat MIME object.  Then get the body of the 1st sub-part.
    mime = CkMimeW_Create();
    CkMimeW_LoadMime(mime,CkHttpResponseW_fullMime(resp));

    // Your code might verify that the Content-Type is indeed multipart/related.
    wprintf(L"%s\n",CkMimeW_contentType(mime));
    wprintf(L"num parts = %d\n",CkMimeW_getNumParts(mime));

    // Assuming it is, and the number of sub-parts is > 0
    if (CkMimeW_getNumParts(mime) > 0) {

        part0 = CkMimeW_Create();
        CkMimeW_PartAt(mime,0,part0);

        // The Content-Type (in this ficticious example) should be "application/xop+xml"
        wprintf(L"sub-part Content-Type: %s\n",CkMimeW_contentType(part0));
        // Now get the XML 
        subPartXmlBody = CkMimeW_getBodyDecoded(part0);
        wprintf(L"%s\n",subPartXmlBody);
    }



    CkHttpW_Dispose(http);
    CkXmlW_Dispose(soapXml);
    CkHttpRequestW_Dispose(req);
    CkHttpResponseW_Dispose(resp);
    CkMimeW_Dispose(mime);
    CkMimeW_Dispose(part0);

    }