Xbase++ Requires Chilkat v11.0.0+
Xbase++
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 Xbase++ Downloads
LOCAL nSuccess
LOCAL oHttp
LOCAL oUrl
LOCAL oMediaBase
LOCAL oDownload
LOCAL oFileResp
LOCAL oFileUrl
LOCAL oFilename
LOCAL oMediaSid
LOCAL nSaved
LOCAL oResp
LOCAL oReply
LOCAL nMore
LOCAL nParsed
LOCAL nCount
LOCAL i
nSuccess := 0
// Assumes Chilkat is unlocked. See Global Unlock Sample.
// Load an API key for the Twilio account from private application configuration.
oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
oHttp:BasicAuth := 1
oHttp:Login := "YOUR_API_KEY_SID"
oHttp:Password := "YOUR_API_KEY_SECRET"
oUrl := CreateObject("Chilkat.StringBuilder")
oUrl:Append("https://api.twilio.com/2010-04-01/Accounts/")
oUrl:Append("YOUR_ACCOUNT_SID")
oUrl:Append("/Messages")
oUrl:Append("/")
oUrl:Append("YOUR_MESSAGE_SID")
oUrl:Append("/Media")
oMediaBase := CreateObject("Chilkat.StringBuilder")
oMediaBase:AppendSb(oUrl)
oUrl:Append(".json")
// Handle the API redirect explicitly so a signed download uses no Twilio credentials.
oHttp:FollowRedirects := 0
oDownload := CreateObject("Chilkat.Http")
oDownload:RequireSslCertVerify := 1
oFileResp := CreateObject("Chilkat.HttpResponse")
oFileUrl := CreateObject("Chilkat.StringBuilder")
oFilename := CreateObject("Chilkat.StringBuilder")
oMediaSid := CreateObject("Chilkat.StringBuilder")
nSaved := 0
oResp := CreateObject("Chilkat.HttpResponse")
oReply := CreateObject("Chilkat.JsonObject")
nMore := 1
DO WHILE (nMore == 1)
nSuccess := oHttp:HttpNoBody("GET", oUrl:GetAsString(), oResp)
IF (oResp:StatusCode == 0)
? "No HTTP response from Twilio."
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
nParsed := oReply:Load(oResp:BodyStr)
IF ((nSuccess != 1) .OR. (oResp:StatusCode != 200))
? "Twilio returned HTTP " + Str(oResp:StatusCode)
IF ((nParsed == 1) .AND. (oReply:JsonTypeOf("code") == 2))
? "Twilio error: " + Str(oReply:IntOf("code")) + " " + oReply:StringOf("message")
ENDIF
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
IF (nParsed != 1)
? "Expected a JSON response from Twilio."
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
IF (oReply:JsonTypeOf("media_list") != 4)
? "Expected an array of media items."
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
nCount := oReply:SizeOfArray("media_list")
i := 0
DO WHILE (i < nCount)
oReply:I := i
oMediaSid:SetString(oReply:StringOf("media_list[i].sid"))
IF (oMediaSid:Length == 0)
? "Media item is missing its SID."
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
oFileUrl:SetString(oMediaBase:GetAsString())
oFileUrl:Append("/")
oFileUrl:AppendSb(oMediaSid)
nSuccess := oHttp:HttpNoBody("GET", oFileUrl:GetAsString(), oFileResp)
IF ((oFileResp:StatusCode >= 300) .AND. (oFileResp:StatusCode < 400))
oFileUrl:SetString(oFileResp:GetHeaderField("Location"))
IF (oFileUrl:StartsWith("https://", 0) != 1)
? "Expected an HTTPS media download URL."
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
nSuccess := oDownload:HttpNoBody("GET", oFileUrl:GetAsString(), oFileResp)
ENDIF
IF ((nSuccess != 1) .OR. (oFileResp:StatusCode != 200))
? "Media download failed for " + oMediaSid:GetAsString() + ". HTTP " + Str(oFileResp:StatusCode)
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
oFilename:SetString("mms-media-")
oFilename:AppendInt(nSaved + 1)
oFilename:Append(".bin")
nSuccess := oFileResp:SaveBodyBinary(oFilename:GetAsString())
IF (nSuccess == 0)
? oFileResp:LastErrorText
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
? oFilename:GetAsString() + " " + oMediaSid:GetAsString() + " " + oReply:StringOf("media_list[i].content_type")
nSaved := nSaved + 1
i := i + 1
ENDDO
IF (oReply:IsNullOf("next_page_uri") == 1)
nMore := 0
ELSE
oUrl:SetString(oReply:StringOf("next_page_uri"))
IF (oUrl:StartsWith("/2010-04-01/Accounts/", 1) != 1)
? "Expected a Twilio relative next-page URI."
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
oUrl:Prepend("https://api.twilio.com")
ENDIF
ENDDO
? "Media files saved: " + Str(nSaved)
oHttp:destroy()
oUrl:destroy()
oMediaBase:destroy()
oDownload:destroy()
oFileResp:destroy()
oFileUrl:destroy()
oFilename:destroy()
oMediaSid:destroy()
oResp:destroy()
oReply:destroy()