Unicode C Requires Chilkat v11.0.0+
Unicode C
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 Unicode C Downloads
#include <C_CkHttpW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>
void ChilkatSample(void)
{
BOOL success;
HCkHttpW http;
HCkStringBuilderW number;
BOOL encoded;
HCkStringBuilderW url;
HCkHttpResponseW resp;
HCkJsonObjectW reply;
BOOL parsed;
int i;
success = FALSE;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
// Load an API key for the Twilio account from private application configuration.
http = CkHttpW_Create();
CkHttpW_putRequireSslCertVerify(http,TRUE);
CkHttpW_putBasicAuth(http,TRUE);
CkHttpW_putLogin(http,L"YOUR_API_KEY_SID");
CkHttpW_putPassword(http,L"YOUR_API_KEY_SECRET");
// The phone number is one URL path segment. Percent-encode spaces and any leading +.
number = CkStringBuilderW_Create();
CkStringBuilderW_Append(number,L"020 7946 0018");
encoded = CkStringBuilderW_Encode(number,L"url_rfc3986",L"utf-8");
if (encoded != TRUE) {
wprintf(L"Could not encode the phone number.\n");
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
return;
}
url = CkStringBuilderW_Create();
CkStringBuilderW_Append(url,L"https://lookups.twilio.com/v2/PhoneNumbers/");
CkStringBuilderW_Append(url,CkStringBuilderW_getAsString(number));
CkStringBuilderW_Append(url,L"?CountryCode=GB");
resp = CkHttpResponseW_Create();
reply = CkJsonObjectW_Create();
success = CkHttpW_HttpNoBody(http,L"GET",CkStringBuilderW_getAsString(url),resp);
if (CkHttpResponseW_getStatusCode(resp) == 0) {
wprintf(L"No HTTP response from Twilio.\n");
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
CkStringBuilderW_Dispose(url);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(reply);
return;
}
parsed = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
if ((success != TRUE) || (CkHttpResponseW_getStatusCode(resp) != 200)) {
wprintf(L"Twilio returned HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
if ((parsed == TRUE) && (CkJsonObjectW_JsonTypeOf(reply,L"code") == 2)) {
wprintf(L"Twilio error: %d %s\n",CkJsonObjectW_IntOf(reply,L"code"),CkJsonObjectW_stringOf(reply,L"message"));
}
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
CkStringBuilderW_Dispose(url);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(reply);
return;
}
if (parsed != TRUE) {
wprintf(L"Expected a JSON response from Twilio.\n");
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
CkStringBuilderW_Dispose(url);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(reply);
return;
}
if (CkJsonObjectW_JsonTypeOf(reply,L"valid") != 5) {
wprintf(L"The lookup response is missing the validity flag.\n");
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
CkStringBuilderW_Dispose(url);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(reply);
return;
}
if (CkJsonObjectW_BoolOf(reply,L"valid") != TRUE) {
wprintf(L"The number is invalid for the specified country.\n");
i = 0;
while ((i < CkJsonObjectW_SizeOfArray(reply,L"validation_errors"))) {
CkJsonObjectW_putI(reply,i);
wprintf(L"%s\n",CkJsonObjectW_stringOf(reply,L"validation_errors[i]"));
i = i + 1;
}
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
CkStringBuilderW_Dispose(url);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(reply);
return;
}
if (CkJsonObjectW_JsonTypeOf(reply,L"phone_number") != 1) {
wprintf(L"The lookup response is missing the E.164 number.\n");
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
CkStringBuilderW_Dispose(url);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(reply);
return;
}
wprintf(L"E.164: %s\n",CkJsonObjectW_stringOf(reply,L"phone_number"));
wprintf(L"National format: %s\n",CkJsonObjectW_stringOf(reply,L"national_format"));
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(number);
CkStringBuilderW_Dispose(url);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(reply);
}