Zig

Twilio: Send SMS using Basic Authentication

See more REST Examples

Demonstrates how to use Twilio to send an SMS message using Basic authentication. Zig

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

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // Demonstrates how to use Basic Authentication in a REST API call for Twilio.
    // Sends an SMS text message..

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

    const rest = try chilkat.Rest.init();
    defer rest.deinit();

    // Use Basic Authentication.
    // Your Twilio Account SID is the username.
    // Your Twilio Auth Token is the password.
    try rest.setAuthBasic("TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN");

    // Make the initial connection (without sending a request yet) to Twilio.
    const b_tls = true;
    const port = 443;
    const b_auto_reconnect = true;
    rest.connect("api.twilio.com", port, b_tls, b_auto_reconnect) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // Provide the information for the SMS text message:
    try rest.addQueryParam("To", "+16518675309");
    try rest.addQueryParam("From", "+15005550006");
    try rest.addQueryParam("Body", "Hey Jenny! Good luck on the bar exam!");
    try rest.addQueryParam("MediaUrl", "http://farm2.static.flickr.com/1075/1404618563_3ed9a44a3a.jpg");

    // Send the SMS text message.
    // Your Twilio Account SID is part of the URI path:
    const response_json = rest.fullRequestFormUrlEncoded(alloc, "POST", "/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // When successful, the response status code will equal 201.
    if (rest.getResponseStatusCode() != 201) {
        // Examine the request/response to see what happened.
        std.debug.print("response status code = {d}\n", .{rest.getResponseStatusCode()});
        std.debug.print("response status text = {s}\n", .{try rest.getResponseStatusText(alloc)});
        std.debug.print("response header: {s}\n", .{try rest.getResponseHeader(alloc)});
        std.debug.print("response body (if any): {s}\n", .{response_json});
        std.debug.print("---\n", .{});
        std.debug.print("LastRequestStartLine: {s}\n", .{try rest.getLastRequestStartLine(alloc)});
        std.debug.print("LastRequestHeader: {s}\n", .{try rest.getLastRequestHeader(alloc)});
        return;
    }

    // The response is JSON.  We'll show how to get a few bits of information from it.
    // A full sample JSON response is shown below..

    const json = try chilkat.JsonObject.init();
    defer json.deinit();
    json.setEmitCompact(false);
    try json.load(response_json);

    // First show the entire JSON.
    std.debug.print("{s}\n", .{try json.emit(alloc)});

    // Now get some individual pieces of information:
    std.debug.print("sid: {s}\n", .{try json.stringOf(alloc, "sid")});
    std.debug.print("body: {s}\n", .{try json.stringOf(alloc, "body")});
    std.debug.print("media: {s}\n", .{try json.stringOf(alloc, "subresource_uris.media")});

    std.debug.print("Success.\n", .{});

    // Sample JSON response:

    // {
    //   "sid": "MM97ecfd43e9f24e99b0c2c6ee016949e3",
    //   "date_created": null,
    //   "date_updated": null,
    //   "date_sent": null,
    //   "account_sid": "112e1111e0151133d11112101111d1111",
    //   "to": "+16518675309",
    //   "from": "+15005550006",
    //   "messaging_service_sid": null,
    //   "body": "Sent from your Twilio trial account - Hey Jenny! Good luck on the bar exam!",
    //   "status": "queued",
    //   "num_segments": "1",
    //   "num_media": "0",
    //   "direction": "outbound-api",
    //   "api_version": "2010-04-01",
    //   "price": null,
    //   "price_unit": "USD",
    //   "error_code": null,
    //   "error_message": null,
    //   "uri": "/2010-04-01/Accounts/AC2e9b6bc0f51133df24926f07341d3824/Messages/MM97ecfd43e9f24e99b0c2c6ee016949e3.json",
    //   "subresource_uris": {
    //     "media": "/2010-04-01/Accounts/AC2e9b6bc0f51133df24926f07341d3824/Messages/MM97ecfd43e9f24e99b0c2c6ee016949e3/Media.json"
    //   }
    // }
}