Sample code for 30+ languages & platforms
C

Add Data to multipart/form-data Request

See more HTTP Examples

Demonstrates how to add content (such as a JPG, PDF, XML, etc.) to multipart/form-data requests.

Chilkat C Downloads

C
#include <C_CkHttpRequest.h>
#include <C_CkBinData.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpRequest req;
    HCkBinData bd;

    success = FALSE;

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

    req = CkHttpRequest_Create();
    CkHttpRequest_putHttpVerb(req,"POST");
    CkHttpRequest_putContentType(req,"multipart/form-data");
    CkHttpRequest_putPath(req,"/xyz/something");

    CkHttpRequest_AddParam(req,"param1","value1");
    CkHttpRequest_AddParam(req,"param2","value2");

    // Add some small files to the request. (Small so we can see what the full request looks like without too much data..)
    bd = CkBinData_Create();
    success = CkBinData_LoadFile(bd,"qa_data/jpg/starfish20.jpg");
    CkHttpRequest_AddBdForUpload(req,"starfish20","starfish20.jpg",bd,"image/jpeg");

    success = CkBinData_LoadFile(bd,"qa_data/pdf/helloWorld.pdf");
    CkHttpRequest_AddBdForUpload(req,"helloWorld","helloWorld.pdf",bd,"application/pdf");

    success = CkBinData_LoadFile(bd,"qa_data/xml/tinyA.xml");
    CkHttpRequest_AddBdForUpload(req,"tinyA","tinyA.xml",bd,"text/xml");

    // This HTTP request contains binary data, so we cannot call GenerateRequestText
    // to examine it as a string.  We can instead call GenerateRequestFile
    // to write the request to a file and then examine using a hex editor,
    // or an editor that is capable of handling null bytes and non-printable chars (perhaps by displaying "?" chars instead).
    CkHttpRequest_GenerateRequestFile(req,"qa_output/multipartFormDataRequest.bin");

    printf("OK.\n");

    // This is the HTTP multipart/form-data request built by the above code:

    // POST /xyz/something HTTP/1.1
    // Host: domain
    // Content-Type: multipart/form-data; boundary=------------090708030009010000030901
    // Content-Length: 2220
    // 
    // --------------090708030009010000030901
    // Content-Disposition: form-data; name="param1"
    // 
    // value1
    // --------------090708030009010000030901
    // Content-Disposition: form-data; name="param2"
    // 
    // value2
    // --------------090708030009010000030901
    // Content-Disposition: form-data; name="starfish20"; filename="starfish20.jpg"
    // Content-Type: image/jpeg
    // 
    // JPEG DATA HERE...
    // --------------090708030009010000030901
    // Content-Disposition: form-data; name="helloWorld"; filename="helloWorld.pdf"
    // Content-Type: application/pdf
    // 
    // PDF DATA HERE...
    // --------------090708030009010000030901
    // Content-Disposition: form-data; name="tinyA"; filename="tinyA.xml"
    // Content-Type: text/xml
    // 
    // XML DATA HERE...
    // --------------090708030009010000030901--
    // 


    CkHttpRequest_Dispose(req);
    CkBinData_Dispose(bd);

    }