代替表現
カスタム URL
API URL の CNAME を作成し、選択したホスト名からレコーディングメディアを提供できます!そのためには、CNAME レコードを、api.twilio.com をポイントする DNS プロバイダーで作成します。
代替表現
Twilioの2010年版API (api.twilio.com/2010-04-01/Accounts 以下のリソースURIも持つもの) は既定ではXMLでレスポンスを返しますが、JSON、CSV、さらにはHTMLでも返すことができます。 (メモ: productname.twilio.com/v1 という形式を取る、より新しいAPIはJSONのレスポンスのみに対応しています。)
CSV
REST URL の末尾に .csv をつけると、ヘッダー行に列の内容を示す カンマ区切り値 (CSV) 表現のデータを取得できます。たとえば、次の Calls リソースにリクエストを発行すると、デフォルトの表現は XML になります。
GET /2010-04-01/Accounts/AC30947.../Calls
<TwilioResponse>
<Calls page="0" numpages="1" pagesize="50" total="38" start="0" end="37">
<Call>
<Sid>CA42ed11f93dc08b952027ffbc406d0868</Sid>
<DateCreated>Sat, 07 Feb 2009 13:15:19 +0000</DateCreated>
<DateUpdated>Sat, 07 Feb 2009 13:15:19 +0000</DateUpdated>
<AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>
<To>+14159633717</To>
<From>+14156767925</From>
<PhoneNumberSid>PN012345678901246789012345678900</PhoneNumberSid>
<Status>completed</Status>
<StartTime>Thu, 03 Apr 2008 04:36:33 +0000</StartTime>
<EndTime>Thu, 03 Apr 2008 04:36:47 +0000</EndTime>
<Duration>14</Duration>
<Price/>
<Flags>
<Flag>inbound</Flag>
</Flags>
</Call>
<Call>
<Sid>CA751e8fa0a0105cf26a0d7a9775fb4bfb</Sid>
<DateCreated>Sat, 07 Feb 2009 13:15:19 +0000</DateCreated>
<DateUpdated>Sat, 07 Feb 2009 13:15:19 +0000</DateUpdated>
<AccountSid>AC309475e5fede1b49e100272a8640f438</AccountSid>
<To>+12064287985</To>
<From>+14156767925</From>
<PhoneNumberSid>PNd59c2ba27ef482647db90476d1674</PhoneNumberSid>
<Status>completed</Status>
<StartTime>Thu, 03 Apr 2008 01:37:05 +0000</StartTime>
<EndTime>Thu, 03 Apr 2008 01:37:40 +0000</EndTime>
<Duration>35</Duration>
<Price/>
<Flags>
<Flag>inbound</Flag>
</Flags>
</Call>
...
</Calls>
</TwilioResponse>
.csv をつけて、同じデータの、MIME-Type が「text/csv」の CSV 表現を取得します。 それぞれの Call がテーブルの行に、各 XML 要素が列になります。
GET /2010-04-01/Accounts/AC30947.../Calls.csv
次が返ります。
Sid, DateCreated, DateUpdated, AccountSid, To, From, ...
CA42ed11f93dc08b952027ffbc406d0868,"Sat, 07 Feb 2009 13:15:19 +0000",
"Sat, 07 Feb 2009 13:15:19 +0000",AC309475e5fede1b49e100272a8640f438,
+14159633717,+14156767925,PN01234567890123456789012345678900,"completed","Thu,
03 Apr 2008 04:36:33 +0000","Thu, 03 Apr 2008 04:36:47 +0000",14,,inbound,,
NOTE: The order of the columns in the CSV is not defined and may change when new fields are added to the API response. Your application design should be resilient to changes in the order of the columns in the CSV response.
JSON
REST URL の末尾に .json をつけて、JSON レスポンスを要求することもできます。 レスポンスの MIME-Type は、application/json となります。
API バージョン 2010-04-01 では、それ以前の REST API バージョンよりも新しいフォーマットで JSON レスポンスを返します。 このフォーマットにはページ情報が含まれ、またリソースの構造もよりシンプルです。
たとえば、IncomingPhoneNumber のレコードを JSON で取得すると、次のようになります。
GET /2010-04-01/Accounts/AC33d49.../IncomingPhoneNumbers.json
{
"incoming_phone_numbers":[
{
"sid":"PNd6b0e1e84f7b117332aed2fd2e5bbcab",
"account_sid":"AC228ba7a5fe4238be081ea6f3c44186f3",
"friendly_name":"My Phone Number",
"phone_number":"+15104444444",
"voice_url":"",
"voice_method":"POST",
"voice_fallback_url":"",
"voice_fallback_method":"POST",
"voice_caller_id_lookup":false,
"date_created":"Thu, 29 Jul 2010 21:00:17 +0000","
date_updated":"Mon, 09 Aug 2010 22:14:20 +0000",
"sms_url":"http:\/\/www.google.com",
"sms_method":"POST",
"sms_fallback_url":"",
"sms_fallback_method":"POST",
"capabilities": {
"voice":true,
"sms":true
},
"status_callback":null,
"status_callback_method":null,
"api_version":"2008-08-01",
"uri":"\/2010-04-01\/Accounts\/AC228ba7a5fe4238be081ea6f3c44186f3\/IncomingPhoneNumbers\/PNd6b0e1e84f7b117332aed2fd2e5bbcab.json"
}
],
"page":0,
"num_pages":1,
"page_size":50,
"total":2,
"start":0,
"end":1,
"uri":"\/2010-04-01\/Accounts\/AC228ba7a5fe4238be081ea6f3c44186f3\/IncomingPhoneNumbers.json",
"first_page_uri":"\/2010-04-01\/Accounts\/AC228ba7a5fe4238be081ea6f3c44186f3\/IncomingPhoneNumbers.json?Page=0&PageSize=50",
"previous_page_uri":null,
"next_page_uri":null,
"last_page_uri":"\/2010-04-01\/Accounts\/AC228ba7a5fe4238be081ea6f3c44186f3\/IncomingPhoneNumbers.json?Page=0&PageSize=50"
}
HTML
You can also get Twilio to return the same objects formatted as HTML by appending a .html to the end of any url. This may be useful if you intend to pass this data directly to a browser, but will require you to complete the URIs with the correct subdomain (generally api.twilio.com).
たとえば、次のアカウントの XML 表現を見てみましょう。
GET /2010-04-01/Accounts/AC35542fc30a091bed0c1ed511e1d9935d
<TwilioResponse>
<Account>
<Sid>AC228ba7a5fe4238be081ea6f3c44186f3</Sid>
<FriendlyName>folly@folly.com's Account</FriendlyName>
<Status>Active</Status>
<DateCreated>Tue, 27 Jul 2010 01:54:11 +0000</DateCreated>
<DateUpdated>Thu, 29 Jul 2010 20:59:01 +0000</DateUpdated>
<AuthToken>f9dd7f4177babe34369f719e1d76c0df</AuthToken>
<Uri>/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3</Uri>
<SubresourceUris>
<AvailablePhoneNumbers>/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3/AvailablePhoneNumbers.xml</AvailablePhoneNumbers>
<Calls>/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3/Calls.xml</Calls>
...
</SubresourceUris>
</Account>
</TwilioResponse>
同じリソースの HTML 表現は、次のようになります。 URI に .html がついています。
GET /2010-04-01/Accounts/AC35542fc30a091bed0c1ed511e1d9935d.html
<html>
<head><title>200</title></head>
<body class="twilio-response">
<div class="account">
<h1>Account</h1>
<dl>
<dt>sid</dt>
<dd>AC228ba7a5fe4238be081ea6f3c44186f3</dd>
<dt>friendly-name</dt>
<dd>folly@folly.com's Account</dd>
<dt>status</dt>
<dd>Active</dd>
<dt>date-created</dt>
<dd>Tue, 27 Jul 2010 01:54:11 +0000</dd>
<dt>date-updated</dt>
<dd>Thu, 29 Jul 2010 20:59:01 +0000</dd>
<dt>auth-token</dt>
<dd>f9dd7f4177babe34369f719e1d76c0df</dd>
<dt>uri</dt>
<dd><a href="/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3.html">/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3.html</a></dd>
<dt>subresource-uris</dt>
<dd>
<dl class="subresource-uris">
<dt>available-phone-numbers</dt>
<dd><a href="/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3/AvailablePhoneNumbers.html">/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3/AvailablePhoneNumbers.html</a></dd>
<dt>calls</dt>
<dd><a href="/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3/Calls.html">/2010-04-01/Accounts/AC228ba7a5fe4238be081ea6f3c44186f3/Calls.html</a></dd>
<dt>conferences</dt>
...
</dl></dd>
</dl>
</div>
</body>
</html>
ヘルプが必要ですか？
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.