Tcl Requires Chilkat v11.0.0+
Tcl
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 Tcl Downloads
load ./chilkat.dll
set success 0
# Assumes Chilkat is unlocked. See Global Unlock Sample.
# Load an API key for the Twilio account from private application configuration.
set http [new_CkHttp]
CkHttp_put_RequireSslCertVerify $http 1
CkHttp_put_BasicAuth $http 1
CkHttp_put_Login $http "YOUR_API_KEY_SID"
CkHttp_put_Password $http "YOUR_API_KEY_SECRET"
set url [new_CkStringBuilder]
CkStringBuilder_Append $url "https://api.twilio.com/2010-04-01/Accounts/"
CkStringBuilder_Append $url "YOUR_ACCOUNT_SID"
CkStringBuilder_Append $url "/Messages"
CkStringBuilder_Append $url "/"
CkStringBuilder_Append $url "YOUR_MESSAGE_SID"
CkStringBuilder_Append $url "/Media"
set mediaBase [new_CkStringBuilder]
CkStringBuilder_AppendSb $mediaBase $url
CkStringBuilder_Append $url ".json"
# Handle the API redirect explicitly so a signed download uses no Twilio credentials.
CkHttp_put_FollowRedirects $http 0
set download [new_CkHttp]
CkHttp_put_RequireSslCertVerify $download 1
set fileResp [new_CkHttpResponse]
set fileUrl [new_CkStringBuilder]
set filename [new_CkStringBuilder]
set mediaSid [new_CkStringBuilder]
set saved 0
set resp [new_CkHttpResponse]
set reply [new_CkJsonObject]
set more 1
while {$more == 1} {
set success [CkHttp_HttpNoBody $http "GET" [CkStringBuilder_getAsString $url] $resp]
if {[CkHttpResponse_get_StatusCode $resp] == 0} then {
puts "No HTTP response from Twilio."
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
set parsed [CkJsonObject_Load $reply [CkHttpResponse_bodyStr $resp]]
if {expr [$success != 1] || [[CkHttpResponse_get_StatusCode $resp] != 200]} then {
puts "Twilio returned HTTP [CkHttpResponse_get_StatusCode $resp]"
if {expr [$parsed == 1] && [[CkJsonObject_JsonTypeOf $reply "code"] == 2]} then {
puts "Twilio error: [CkJsonObject_IntOf $reply code] [CkJsonObject_stringOf $reply message]"
}
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
if {$parsed != 1} then {
puts "Expected a JSON response from Twilio."
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
if {[CkJsonObject_JsonTypeOf $reply "media_list"] != 4} then {
puts "Expected an array of media items."
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
set count [CkJsonObject_SizeOfArray $reply "media_list"]
set i 0
while {$i < $count} {
CkJsonObject_put_I $reply $i
CkStringBuilder_SetString $mediaSid [CkJsonObject_stringOf $reply "media_list[i].sid"]
if {[CkStringBuilder_get_Length $mediaSid] == 0} then {
puts "Media item is missing its SID."
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
CkStringBuilder_SetString $fileUrl [CkStringBuilder_getAsString $mediaBase]
CkStringBuilder_Append $fileUrl "/"
CkStringBuilder_AppendSb $fileUrl $mediaSid
set success [CkHttp_HttpNoBody $http "GET" [CkStringBuilder_getAsString $fileUrl] $fileResp]
if {expr [[CkHttpResponse_get_StatusCode $fileResp] >= 300] && [[CkHttpResponse_get_StatusCode $fileResp] < 400]} then {
CkStringBuilder_SetString $fileUrl [CkHttpResponse_getHeaderField $fileResp "Location"]
if {[CkStringBuilder_StartsWith $fileUrl "https://" 0] != 1} then {
puts "Expected an HTTPS media download URL."
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
set success [CkHttp_HttpNoBody $download "GET" [CkStringBuilder_getAsString $fileUrl] $fileResp]
}
if {expr [$success != 1] || [[CkHttpResponse_get_StatusCode $fileResp] != 200]} then {
puts "Media download failed for [CkStringBuilder_getAsString $mediaSid]. HTTP [CkHttpResponse_get_StatusCode $fileResp]"
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
CkStringBuilder_SetString $filename "mms-media-"
CkStringBuilder_AppendInt $filename [expr $saved + 1]
CkStringBuilder_Append $filename ".bin"
set success [CkHttpResponse_SaveBodyBinary $fileResp [CkStringBuilder_getAsString $filename]]
if {$success == 0} then {
puts [CkHttpResponse_lastErrorText $fileResp]
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
puts [CkStringBuilder_getAsString $filename] [CkStringBuilder_getAsString $mediaSid] [CkJsonObject_stringOf $reply {media_list[i].content_type}]
set saved [expr $saved + 1]
set i [expr $i + 1]
}
if {[CkJsonObject_IsNullOf $reply "next_page_uri"] == 1} then {
set more 0
} else {
CkStringBuilder_SetString $url [CkJsonObject_stringOf $reply "next_page_uri"]
if {[CkStringBuilder_StartsWith $url "/2010-04-01/Accounts/" 1] != 1} then {
puts "Expected a Twilio relative next-page URI."
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
CkStringBuilder_Prepend $url "https://api.twilio.com"
}
}
puts "Media files saved: $saved"
delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkStringBuilder $mediaBase
delete_CkHttp $download
delete_CkHttpResponse $fileResp
delete_CkStringBuilder $fileUrl
delete_CkStringBuilder $filename
delete_CkStringBuilder $mediaSid
delete_CkHttpResponse $resp
delete_CkJsonObject $reply