Tcl Requires Chilkat v11.0.0+
Tcl
Validate and format a phone number with Twilio Lookup
See more Twilio Examples
Use Basic Lookup v2 to check a national-format number and obtain its E.164 and national display formats. Supply the two-letter country code for a national number. The example requests only the basic fields.
Read the boolean valid field even when the HTTP request succeeds. When it is false, display any validation_errors that Twilio supplies. Numbering-plan validation does not establish reachability or control of a phone. To confirm control, send an SMS verification code.
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"
# The phone number is one URL path segment. Percent-encode spaces and any leading +.
set number [new_CkStringBuilder]
CkStringBuilder_Append $number "020 7946 0018"
set encoded [CkStringBuilder_Encode $number "url_rfc3986" "utf-8"]
if {$encoded != 1} then {
puts "Could not encode the phone number."
delete_CkHttp $http
delete_CkStringBuilder $number
exit
}
set url [new_CkStringBuilder]
CkStringBuilder_Append $url "https://lookups.twilio.com/v2/PhoneNumbers/"
CkStringBuilder_Append $url [CkStringBuilder_getAsString $number]
CkStringBuilder_Append $url "?CountryCode=GB"
set resp [new_CkHttpResponse]
set reply [new_CkJsonObject]
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 $number
delete_CkStringBuilder $url
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 $number
delete_CkStringBuilder $url
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
if {$parsed != 1} then {
puts "Expected a JSON response from Twilio."
delete_CkHttp $http
delete_CkStringBuilder $number
delete_CkStringBuilder $url
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
if {[CkJsonObject_JsonTypeOf $reply "valid"] != 5} then {
puts "The lookup response is missing the validity flag."
delete_CkHttp $http
delete_CkStringBuilder $number
delete_CkStringBuilder $url
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
if {[CkJsonObject_BoolOf $reply "valid"] != 1} then {
puts "The number is invalid for the specified country."
set i 0
while {$i < [CkJsonObject_SizeOfArray $reply "validation_errors"]} {
CkJsonObject_put_I $reply $i
puts [CkJsonObject_stringOf $reply {validation_errors[i]}]
set i [expr $i + 1]
}
delete_CkHttp $http
delete_CkStringBuilder $number
delete_CkStringBuilder $url
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
if {[CkJsonObject_JsonTypeOf $reply "phone_number"] != 1} then {
puts "The lookup response is missing the E.164 number."
delete_CkHttp $http
delete_CkStringBuilder $number
delete_CkStringBuilder $url
delete_CkHttpResponse $resp
delete_CkJsonObject $reply
exit
}
puts "E.164: [CkJsonObject_stringOf $reply phone_number]"
puts "National format: [CkJsonObject_stringOf $reply national_format]"
delete_CkHttp $http
delete_CkStringBuilder $number
delete_CkStringBuilder $url
delete_CkHttpResponse $resp
delete_CkJsonObject $reply