Sample code for 30+ languages & platforms
Unicode C Requires Chilkat v11.0.0+

Download the media files from a Twilio MMS

See more Twilio Examples

Supply the Message SID of a received or sent MMS. List its media records, then request each media resource without the .json extension to download the file bytes. Twilio may return a temporary HTTPS download URL. The example uses a separate HTTP client for that URL so the Twilio API key stays with the API host.

Run in an empty output directory. Files are written as mms-media-1.bin, mms-media-2.bin, and so on. The code prints the media SID and MIME type alongside each filename. An empty media list produces a count of zero.

Twilio documentation

Chilkat Unicode C Downloads

Unicode C
#include <C_CkHttpW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkStringBuilderW url;
    HCkStringBuilderW mediaBase;
    HCkHttpW download;
    HCkHttpResponseW fileResp;
    HCkStringBuilderW fileUrl;
    HCkStringBuilderW filename;
    HCkStringBuilderW mediaSid;
    int saved;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    BOOL more;
    BOOL parsed;
    int count;
    int i;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Load an API key for the Twilio account from private application configuration.
    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    CkHttpW_putBasicAuth(http,TRUE);
    CkHttpW_putLogin(http,L"YOUR_API_KEY_SID");
    CkHttpW_putPassword(http,L"YOUR_API_KEY_SECRET");

    url = CkStringBuilderW_Create();
    CkStringBuilderW_Append(url,L"https://api.twilio.com/2010-04-01/Accounts/");
    CkStringBuilderW_Append(url,L"YOUR_ACCOUNT_SID");
    CkStringBuilderW_Append(url,L"/Messages");
    CkStringBuilderW_Append(url,L"/");
    CkStringBuilderW_Append(url,L"YOUR_MESSAGE_SID");
    CkStringBuilderW_Append(url,L"/Media");
    mediaBase = CkStringBuilderW_Create();
    CkStringBuilderW_AppendSb(mediaBase,url);
    CkStringBuilderW_Append(url,L".json");
    //  Handle the API redirect explicitly so a signed download uses no Twilio credentials.
    CkHttpW_putFollowRedirects(http,FALSE);
    download = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(download,TRUE);
    fileResp = CkHttpResponseW_Create();
    fileUrl = CkStringBuilderW_Create();
    filename = CkStringBuilderW_Create();
    mediaSid = CkStringBuilderW_Create();
    saved = 0;
    resp = CkHttpResponseW_Create();
    reply = CkJsonObjectW_Create();

    more = TRUE;
    while ((more == TRUE)) {
        success = CkHttpW_HttpNoBody(http,L"GET",CkStringBuilderW_getAsString(url),resp);
        if (CkHttpResponseW_getStatusCode(resp) == 0) {
            wprintf(L"No HTTP response from Twilio.\n");
            CkHttpW_Dispose(http);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(mediaBase);
            CkHttpW_Dispose(download);
            CkHttpResponseW_Dispose(fileResp);
            CkStringBuilderW_Dispose(fileUrl);
            CkStringBuilderW_Dispose(filename);
            CkStringBuilderW_Dispose(mediaSid);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            return;
        }

        parsed = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
        if ((success != TRUE) || (CkHttpResponseW_getStatusCode(resp) != 200)) {
            wprintf(L"Twilio returned HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
            if ((parsed == TRUE) && (CkJsonObjectW_JsonTypeOf(reply,L"code") == 2)) {
                wprintf(L"Twilio error: %d  %s\n",CkJsonObjectW_IntOf(reply,L"code"),CkJsonObjectW_stringOf(reply,L"message"));
            }

            CkHttpW_Dispose(http);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(mediaBase);
            CkHttpW_Dispose(download);
            CkHttpResponseW_Dispose(fileResp);
            CkStringBuilderW_Dispose(fileUrl);
            CkStringBuilderW_Dispose(filename);
            CkStringBuilderW_Dispose(mediaSid);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            return;
        }

        if (parsed != TRUE) {
            wprintf(L"Expected a JSON response from Twilio.\n");
            CkHttpW_Dispose(http);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(mediaBase);
            CkHttpW_Dispose(download);
            CkHttpResponseW_Dispose(fileResp);
            CkStringBuilderW_Dispose(fileUrl);
            CkStringBuilderW_Dispose(filename);
            CkStringBuilderW_Dispose(mediaSid);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            return;
        }

        if (CkJsonObjectW_JsonTypeOf(reply,L"media_list") != 4) {
            wprintf(L"Expected an array of media items.\n");
            CkHttpW_Dispose(http);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(mediaBase);
            CkHttpW_Dispose(download);
            CkHttpResponseW_Dispose(fileResp);
            CkStringBuilderW_Dispose(fileUrl);
            CkStringBuilderW_Dispose(filename);
            CkStringBuilderW_Dispose(mediaSid);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            return;
        }

        count = CkJsonObjectW_SizeOfArray(reply,L"media_list");
        i = 0;
        while ((i < count)) {
            CkJsonObjectW_putI(reply,i);
            CkStringBuilderW_SetString(mediaSid,CkJsonObjectW_stringOf(reply,L"media_list[i].sid"));
            if (CkStringBuilderW_getLength(mediaSid) == 0) {
                wprintf(L"Media item is missing its SID.\n");
                CkHttpW_Dispose(http);
                CkStringBuilderW_Dispose(url);
                CkStringBuilderW_Dispose(mediaBase);
                CkHttpW_Dispose(download);
                CkHttpResponseW_Dispose(fileResp);
                CkStringBuilderW_Dispose(fileUrl);
                CkStringBuilderW_Dispose(filename);
                CkStringBuilderW_Dispose(mediaSid);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                return;
            }

            CkStringBuilderW_SetString(fileUrl,CkStringBuilderW_getAsString(mediaBase));
            CkStringBuilderW_Append(fileUrl,L"/");
            CkStringBuilderW_AppendSb(fileUrl,mediaSid);
            success = CkHttpW_HttpNoBody(http,L"GET",CkStringBuilderW_getAsString(fileUrl),fileResp);
            if ((CkHttpResponseW_getStatusCode(fileResp) >= 300) && (CkHttpResponseW_getStatusCode(fileResp) < 400)) {
                CkStringBuilderW_SetString(fileUrl,CkHttpResponseW_getHeaderField(fileResp,L"Location"));
                if (CkStringBuilderW_StartsWith(fileUrl,L"https://",FALSE) != TRUE) {
                    wprintf(L"Expected an HTTPS media download URL.\n");
                    CkHttpW_Dispose(http);
                    CkStringBuilderW_Dispose(url);
                    CkStringBuilderW_Dispose(mediaBase);
                    CkHttpW_Dispose(download);
                    CkHttpResponseW_Dispose(fileResp);
                    CkStringBuilderW_Dispose(fileUrl);
                    CkStringBuilderW_Dispose(filename);
                    CkStringBuilderW_Dispose(mediaSid);
                    CkHttpResponseW_Dispose(resp);
                    CkJsonObjectW_Dispose(reply);
                    return;
                }

                success = CkHttpW_HttpNoBody(download,L"GET",CkStringBuilderW_getAsString(fileUrl),fileResp);
            }

            if ((success != TRUE) || (CkHttpResponseW_getStatusCode(fileResp) != 200)) {
                wprintf(L"Media download failed for %s. HTTP %d\n",CkStringBuilderW_getAsString(mediaSid),CkHttpResponseW_getStatusCode(fileResp));
                CkHttpW_Dispose(http);
                CkStringBuilderW_Dispose(url);
                CkStringBuilderW_Dispose(mediaBase);
                CkHttpW_Dispose(download);
                CkHttpResponseW_Dispose(fileResp);
                CkStringBuilderW_Dispose(fileUrl);
                CkStringBuilderW_Dispose(filename);
                CkStringBuilderW_Dispose(mediaSid);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                return;
            }

            CkStringBuilderW_SetString(filename,L"mms-media-");
            CkStringBuilderW_AppendInt(filename,saved + 1);
            CkStringBuilderW_Append(filename,L".bin");
            success = CkHttpResponseW_SaveBodyBinary(fileResp,CkStringBuilderW_getAsString(filename));
            if (success == FALSE) {
                wprintf(L"%s\n",CkHttpResponseW_lastErrorText(fileResp));
                CkHttpW_Dispose(http);
                CkStringBuilderW_Dispose(url);
                CkStringBuilderW_Dispose(mediaBase);
                CkHttpW_Dispose(download);
                CkHttpResponseW_Dispose(fileResp);
                CkStringBuilderW_Dispose(fileUrl);
                CkStringBuilderW_Dispose(filename);
                CkStringBuilderW_Dispose(mediaSid);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                return;
            }

            wprintf(L"%s  %s  %s\n",CkStringBuilderW_getAsString(filename),CkStringBuilderW_getAsString(mediaSid),CkJsonObjectW_stringOf(reply,L"media_list[i].content_type"));
            saved = saved + 1;
            i = i + 1;
        }

        if (CkJsonObjectW_IsNullOf(reply,L"next_page_uri") == TRUE) {
            more = FALSE;
        }
        else {
            CkStringBuilderW_SetString(url,CkJsonObjectW_stringOf(reply,L"next_page_uri"));
            if (CkStringBuilderW_StartsWith(url,L"/2010-04-01/Accounts/",TRUE) != TRUE) {
                wprintf(L"Expected a Twilio relative next-page URI.\n");
                CkHttpW_Dispose(http);
                CkStringBuilderW_Dispose(url);
                CkStringBuilderW_Dispose(mediaBase);
                CkHttpW_Dispose(download);
                CkHttpResponseW_Dispose(fileResp);
                CkStringBuilderW_Dispose(fileUrl);
                CkStringBuilderW_Dispose(filename);
                CkStringBuilderW_Dispose(mediaSid);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                return;
            }

            CkStringBuilderW_Prepend(url,L"https://api.twilio.com");
        }

    }

    wprintf(L"Media files saved: %d\n",saved);


    CkHttpW_Dispose(http);
    CkStringBuilderW_Dispose(url);
    CkStringBuilderW_Dispose(mediaBase);
    CkHttpW_Dispose(download);
    CkHttpResponseW_Dispose(fileResp);
    CkStringBuilderW_Dispose(fileUrl);
    CkStringBuilderW_Dispose(filename);
    CkStringBuilderW_Dispose(mediaSid);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);

    }