Sample code for 30+ languages & platforms
Xbase++ 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 Xbase++ Downloads

Xbase++
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()