Zig

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. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main() !void {
    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    const req = try chilkat.HttpRequest.init();
    defer req.deinit();
    req.setHttpVerb("POST");
    req.setContentType("multipart/form-data");
    req.setPath("/xyz/something");

    req.addParam("param1", "value1");
    req.addParam("param2", "value2");

    // Add some small files to the request. (Small so we can see what the full request looks like without too much data..)
    const bd = try chilkat.BinData.init();
    defer bd.deinit();
    try bd.loadFile("qa_data/jpg/starfish20.jpg");
    req.addBdForUpload("starfish20", "starfish20.jpg", bd, "image/jpeg") catch {};

    try bd.loadFile("qa_data/pdf/helloWorld.pdf");
    req.addBdForUpload("helloWorld", "helloWorld.pdf", bd, "application/pdf") catch {};

    try bd.loadFile("qa_data/xml/tinyA.xml");
    req.addBdForUpload("tinyA", "tinyA.xml", bd, "text/xml") catch {};

    // 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).
    req.generateRequestFile("qa_output/multipartFormDataRequest.bin") catch {};

    std.debug.print("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--
    //
}