メニュー

Expand
ページを評価:

代替表現

カスタム 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.

        
        
        

        フィードバックくださりありがとうございます!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        ステップ1

        Get link

        Get a free personal referral link here

        ステップ2:

        Give $10

        Your user signs up and upgrade using link

        ステップ3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more