C++ Requires Chilkat v11.0.0+
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 C++ Downloads
#include <CkHttp.h>
#include <CkStringBuilder.h>
#include <CkHttpResponse.h>
#include <CkJsonObject.h>
void ChilkatSample(void)
{
bool success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
// Load an API key for the Twilio account from private application configuration.
CkHttp http;
http.put_RequireSslCertVerify(true);
http.put_BasicAuth(true);
http.put_Login("YOUR_API_KEY_SID");
http.put_Password("YOUR_API_KEY_SECRET");
CkStringBuilder url;
url.Append("https://api.twilio.com/2010-04-01/Accounts/");
url.Append("YOUR_ACCOUNT_SID");
url.Append("/Messages");
url.Append("/");
url.Append("YOUR_MESSAGE_SID");
url.Append("/Media");
CkStringBuilder mediaBase;
mediaBase.AppendSb(url);
url.Append(".json");
// Handle the API redirect explicitly so a signed download uses no Twilio credentials.
http.put_FollowRedirects(false);
CkHttp download;
download.put_RequireSslCertVerify(true);
CkHttpResponse fileResp;
CkStringBuilder fileUrl;
CkStringBuilder filename;
CkStringBuilder mediaSid;
int saved = 0;
CkHttpResponse resp;
CkJsonObject reply;
bool more = true;
while ((more == true)) {
success = http.HttpNoBody("GET",url.getAsString(),resp);
if (resp.get_StatusCode() == 0) {
std::cout << "No HTTP response from Twilio." << "\r\n";
return;
}
bool parsed = reply.Load(resp.bodyStr());
if ((success != true) || (resp.get_StatusCode() != 200)) {
std::cout << "Twilio returned HTTP " << resp.get_StatusCode() << "\r\n";
if ((parsed == true) && (reply.JsonTypeOf("code") == 2)) {
std::cout << "Twilio error: " << reply.IntOf("code") << " " << reply.stringOf("message") << "\r\n";
}
return;
}
if (parsed != true) {
std::cout << "Expected a JSON response from Twilio." << "\r\n";
return;
}
if (reply.JsonTypeOf("media_list") != 4) {
std::cout << "Expected an array of media items." << "\r\n";
return;
}
int count = reply.SizeOfArray("media_list");
int i = 0;
while ((i < count)) {
reply.put_I(i);
mediaSid.SetString(reply.stringOf("media_list[i].sid"));
if (mediaSid.get_Length() == 0) {
std::cout << "Media item is missing its SID." << "\r\n";
return;
}
fileUrl.SetString(mediaBase.getAsString());
fileUrl.Append("/");
fileUrl.AppendSb(mediaSid);
success = http.HttpNoBody("GET",fileUrl.getAsString(),fileResp);
if ((fileResp.get_StatusCode() >= 300) && (fileResp.get_StatusCode() < 400)) {
fileUrl.SetString(fileResp.getHeaderField("Location"));
if (fileUrl.StartsWith("https://",false) != true) {
std::cout << "Expected an HTTPS media download URL." << "\r\n";
return;
}
success = download.HttpNoBody("GET",fileUrl.getAsString(),fileResp);
}
if ((success != true) || (fileResp.get_StatusCode() != 200)) {
std::cout << "Media download failed for " << mediaSid.getAsString() << ". HTTP " << fileResp.get_StatusCode() << "\r\n";
return;
}
filename.SetString("mms-media-");
filename.AppendInt(saved + 1);
filename.Append(".bin");
success = fileResp.SaveBodyBinary(filename.getAsString());
if (success == false) {
std::cout << fileResp.lastErrorText() << "\r\n";
return;
}
std::cout << filename.getAsString() << " " << mediaSid.getAsString() << " " << reply.stringOf("media_list[i].content_type") << "\r\n";
saved = saved + 1;
i = i + 1;
}
if (reply.IsNullOf("next_page_uri") == true) {
more = false;
}
else {
url.SetString(reply.stringOf("next_page_uri"));
if (url.StartsWith("/2010-04-01/Accounts/",true) != true) {
std::cout << "Expected a Twilio relative next-page URI." << "\r\n";
return;
}
url.Prepend("https://api.twilio.com");
}
}
std::cout << "Media files saved: " << saved << "\r\n";
}