Unicode C Requires Chilkat v11.0.0+
Unicode C
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.
Chilkat Unicode C Downloads
#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);
}