Sample code for 30+ languages & platforms
Unicode C

Send SOAP multipart/related with XML Body and Zip Attachment

See more REST Misc Examples

Demonstrates how to construct and send a multipart/related POST containing a SOAP XML body and a binary zip attachment.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkRestW.h>
#include <C_CkXmlW.h>
#include <C_CkBinDataW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkRestW rest;
    HCkXmlW xml;
    HCkBinDataW bd;
    BOOL bAutoReconnect;
    const wchar_t *responseStr;
    HCkBinDataW bdRequest;

    success = FALSE;

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

    // This example constructs and sends the following HTTP request.
    // (The boundary strings will be different and auto-generated by Chilkat)

    // Accept-Encoding: gzip,deflate
    // SOAPAction: invio
    // Content-Type: Multipart/Related; boundary="MIME_boundary"; type="text/xml"; start="mailto:rootpart@soapui.org"
    // MIME-Version: 1.0
    // 
    // --MIME_boundary
    // Content-Type: text/xml; charset=UTF-8
    // Content-Transfer-Encoding: 8bit
    // Content-ID: <rootpart@soapui.org>
    //  
    // <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:attachment.ws.it">
    // <soapenv:Header/>
    // <soapenv:Body>
    //   <urn:inputBean>
    //    <nomeFileAllegato>myfile.zip</nomeFileAllegato>
    //   </urn:inputBean>
    // </soapenv:Body>
    // </soapenv:Envelope>
    //  
    // --MIME_boundary
    // Content-Type: application/zip
    // Content-Transfer-Encoding: binary
    // Content-ID: <myfile.zip>
    // Content-Disposition: attachment; name="myfile.zip"; filename="myfile.zip"
    // 
    // ... binary zip data goes here ...
    // --MIME_boundary--
    // 

    rest = CkRestW_Create();

    CkRestW_AddHeader(rest,L"Accept-Encoding",L"gzip,deflate");
    CkRestW_AddHeader(rest,L"SOAPAction",L"invio");
    CkRestW_AddHeader(rest,L"Content-Type",L"Multipart/Related; boundary=\"MIME_boundary\"; type=\"text/xml\"; start=\"mailto:rootpart@soapui.org\"");
    CkRestW_AddHeader(rest,L"MIME-Version",L"1.0");

    // Build the SOAP XML:
    // Use this online tool to generate the code from sample XML: 
    // Generate Code to Create XML

    xml = CkXmlW_Create();
    CkXmlW_putTag(xml,L"soapenv:Envelope");
    CkXmlW_AddAttribute(xml,L"xmlns:soapenv",L"http://schemas.xmlsoap.org/soap/envelope/");
    CkXmlW_AddAttribute(xml,L"xmlns:urn",L"urn:attachment.ws.it");
    CkXmlW_UpdateChildContent(xml,L"soapenv:Header",L"");
    CkXmlW_UpdateChildContent(xml,L"soapenv:Body|urn:inputBean|nomeFileAllegato",L"myfile.zip");

    // Build the SOAP XML sub-part
    CkRestW_putPartSelector(rest,L"1");
    CkRestW_AddHeader(rest,L"Content-Type",L"text/xml; charset=UTF-8");
    CkRestW_AddHeader(rest,L"Content-Transfer-Encoding",L"8bit");
    CkRestW_AddHeader(rest,L"Content-ID",L"<rootpart@soapui.org>");
    success = CkRestW_SetMultipartBodyString(rest,CkXmlW_getXml(xml));

    // Build the sub-part containing the .zip
    CkRestW_putPartSelector(rest,L"2");
    CkRestW_AddHeader(rest,L"Content-Type",L"application/zip");
    CkRestW_AddHeader(rest,L"Content-Transfer-Encoding",L"binary");
    CkRestW_AddHeader(rest,L"Content-ID",L"<myfile.zip>");
    CkRestW_AddHeader(rest,L"Content-Disposition",L"attachment; name=\"myfile.zip\"; filename=\"myfile.zip\"");

    // Add a zip file to the 2nd sub-part body.
    // This example will load the .zip file into memory, but it is also possible to stream directly from the file as the request is sent
    // by calling SetMultipartBodyStream.
    bd = CkBinDataW_Create();
    success = CkBinDataW_LoadFile(bd,L"qa_data/zips/helloWorld.zip");
    success = CkRestW_SetMultipartBodyBd(rest,bd);

    // To be safe, always revert the PartSelector back to 0..
    CkRestW_putPartSelector(rest,L"0");

    // Send the request by connecting to the web server and then sending..
    // Connect using TLS.
    bAutoReconnect = TRUE;
    success = CkRestW_Connect(rest,L"www.chilkatsoft.com",443,TRUE,bAutoReconnect);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        CkXmlW_Dispose(xml);
        CkBinDataW_Dispose(bd);
        return;
    }

    // In this example, we're setting DebugMode.
    // When debug mode is turned on, no request is actually sent.
    // Instead, the request that would be sent is recorded to memory
    // and we can retrieve it afterwards..
    CkRestW_putDebugMode(rest,TRUE);

    responseStr = CkRestW_fullRequestMultipart(rest,L"POST",L"/someTargetPath");
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        CkXmlW_Dispose(xml);
        CkBinDataW_Dispose(bd);
        return;
    }

    // Retrieve the request that would've been sent and save it to a file.
    // We can then examine the file to see if the request was structured as we desired.
    // (Note: The zip bytes will be binary data and will appear as garbled garbage in a text editor..)
    bdRequest = CkBinDataW_Create();
    CkRestW_GetLastDebugRequest(rest,bdRequest);
    success = CkBinDataW_WriteFile(bdRequest,L"qa_output/multipartRelatedRequest.bin");

    wprintf(L"OK, examine the output file..\n");


    CkRestW_Dispose(rest);
    CkXmlW_Dispose(xml);
    CkBinDataW_Dispose(bd);
    CkBinDataW_Dispose(bdRequest);

    }