Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now

メニュー

Expand
Rate this page:

Thanks for rating this page!

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

REST API: Application

An Application instance resource represents an application that you have created with Twilio. An application inside of Twilio is a set of URLs and other configuration data that tells Twilio how to behave when one of your Twilio numbers receives a call or SMS message. This configuration data is the same configuration data that exists on IncomingPhoneNumber resources: 'VoiceUrl', 'VoiceMethod', 'VoiceFallbackUrl', 'VoiceFallbackMethod', 'StatusCallback', 'StatusCallbackMethod', 'VoiceCallerIdLookup', 'SmsUrl', 'SmsMethod', 'SmsFallbackUrl', 'SmsFallbackMethod', and 'SmsStatusCallback'.

Application のリスト リソースは、あるアカウントの Twilio アプリケーションのセットを表現します。 新しいアプリケーションを作成するには、このリスト リソースに POST します。アカウントには最大 1000 個のアプリケーションを作成できます。

アプリケーションは、複数の電話番号にまたがって使用するコンフィグレーション情報をカプセル化する際に使えます。 ApplicationSid を IncomingPhoneNumber に割り当てることで、Twilio に対して、IncomingPhoneNumber に設定された URL の代わりに、アプリケーションの URL を使用するよう指示できます。 アプリケーションを作成し、VoiceUrl をhttp://myapp.com/answer にセットします。このアプリケーションをすべての自分の電話番号に割り当てると、通話が着信するたびに、Twilio は この URL へリクエストを送信します。

Application properties

Names in PHP format
accountSid
sid<AC> Not PII

The SID of the Account that created the Application resource.

apiVersion
文字列 Not PII

The API version used to start a new TwiML session.

dateCreated
date_time<rfc2822> Not PII

The date and time in GMT that the resource was created specified in RFC 2822 format.

dateUpdated
date_time<rfc2822> Not PII

The date and time in GMT that the resource was last updated specified in RFC 2822 format.

friendlyName
文字列 Not PII

The string that you assigned to describe the resource.

messageStatusCallback
url Not PII

The URL we call using a POST method to send message status information to your application.

sid
sid<AP> Not PII

The unique string that that we created to identify the Application resource.

smsFallbackMethod
http_method Not PII

The HTTP method we use to call sms_fallback_url. Can be: GET or POST.

smsFallbackUrl
url Not PII

The URL that we call when an error occurs while retrieving or executing the TwiML from sms_url.

smsMethod
http_method Not PII

The HTTP method we use to call sms_url. Can be: GET or POST.

smsStatusCallback
url Not PII

The URL we call using a POST method to send status information to your application about SMS messages that refer to the application.

smsUrl
url Not PII

The URL we call when the phone number receives an incoming SMS message.

statusCallback
url Not PII

The URL we call using the status_callback_method to send status information to your application.

statusCallbackMethod
http_method Not PII

The HTTP method we use to call status_callback. Can be: GET or POST.

uri
uri Not PII

The URI of the resource, relative to https://api.twilio.com.

voiceCallerIdLookup
boolean Not PII

Whether we look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: true or false.

voiceFallbackMethod
http_method Not PII

The HTTP method we use to call voice_fallback_url. Can be: GET or POST.

voiceFallbackUrl
url Not PII

The URL that we call when an error occurs retrieving or executing the TwiML requested by url.

voiceMethod
http_method Not PII

The HTTP method we use to call voice_url. Can be: GET or POST.

voiceUrl
url Not PII

The URL we call when the phone number assigned to this application receives a call.

Create an Application resource

post
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications.json

アカウント内で新しいアプリケーションを作成します。

リクエストが成功すると、Twilio は新しいアプリケーションの表現を返します。

パラメーター
Names in None format
api_version
オプション
post 文字列 Not PII

The API version to use to start a new TwiML session. Can be: 2010-04-01 or 2008-08-01. The default value is the account's default API version.

voice_url
オプション
post url Not PII

The URL we should call when the phone number assigned to this application receives a call.

voice_method
オプション
post http_method Not PII

The HTTP method we should use to call voice_url. Can be: GET or POST.

voice_fallback_url
オプション
post url Not PII

The URL that we should call when an error occurs retrieving or executing the TwiML requested by url.

voice_fallback_method
オプション
post http_method Not PII

The HTTP method we should use to call voice_fallback_url. Can be: GET or POST.

status_callback
オプション
post url Not PII

The URL we should call using the status_callback_method to send status information to your application.

status_callback_method
オプション
post http_method Not PII

The HTTP method we should use to call status_callback. Can be: GET or POST.

voice_caller_id_lookup
オプション
post boolean Not PII

Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: true or false.

sms_url
オプション
post url Not PII

The URL we should call when the phone number receives an incoming SMS message.

sms_method
オプション
post http_method Not PII

The HTTP method we should use to call sms_url. Can be: GET or POST.

sms_fallback_url
オプション
post url Not PII

The URL that we should call when an error occurs while retrieving or executing the TwiML from sms_url.

sms_fallback_method
オプション
post http_method Not PII

The HTTP method we should use to call sms_fallback_url. Can be: GET or POST.

sms_status_callback
オプション
post url Not PII

The URL we should call using a POST method to send status information about SMS messages sent by the application.

message_status_callback
オプション
post url Not PII

The URL we should call using a POST method to send message status information to your application.

friendly_name
オプション
post 文字列 Not PII

A descriptive string that you create to describe the new application. It can be up to 64 characters long.

account_sid
必須
post sid<AC> Not PII

The SID of the Account that will create the resource.

例 1
        
        
        
        

        Fetch an Application resource

        GET
        https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications/{Sid}.json
        パラメーター
        Names in None format
        account_sid
        必須
        GET sid<AC> Not PII

        The SID of the Account that created the Application resource to fetch.

        sid
        必須
        GET sid<AP> Not PII

        The Twilio-provided string that uniquely identifies the Application resource to fetch.

        例 1
              
              
              
              

              Read multiple Application resources

              GET
              https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications.json

              Application リソース表現のリストを返します。各項目は、アカウント内のアプリケーションを表現します。 このリストは ページ情報を含みます。

              パラメーター
              Names in None format
              friendly_name
              オプション
              GET 文字列 Not PII

              The string that identifies the Application resources to read.

              account_sid
              必須
              GET sid<AC> Not PII

              The SID of the Account that created the Application resources to read.

              例 1
                    
                    
                    
                    
                    例 2
                          
                          
                          
                          

                          Update an Application resource

                          post
                          https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications/{Sid}.json

                          アプリケーションのプロパティを更新します。更新に成功すると、更新されたリソース表現を返します。 返却されるレスポンスは、GET リクエストを送信した場合と同じです。

                          パラメーター
                          Names in None format
                          account_sid
                          必須
                          post sid<AC> Not PII

                          The SID of the Account that created the Application resources to update.

                          sid
                          必須
                          post sid<AP> Not PII

                          The Twilio-provided string that uniquely identifies the Application resource to update.

                          friendly_name
                          オプション
                          post 文字列 Not PII

                          A descriptive string that you create to describe the resource. It can be up to 64 characters long.

                          api_version
                          オプション
                          post 文字列 Not PII

                          The API version to use to start a new TwiML session. Can be: 2010-04-01 or 2008-08-01. The default value is your account's default API version.

                          voice_url
                          オプション
                          post url Not PII

                          The URL we should call when the phone number assigned to this application receives a call.

                          voice_method
                          オプション
                          post http_method Not PII

                          The HTTP method we should use to call voice_url. Can be: GET or POST.

                          voice_fallback_url
                          オプション
                          post url Not PII

                          The URL that we should call when an error occurs retrieving or executing the TwiML requested by url.

                          voice_fallback_method
                          オプション
                          post http_method Not PII

                          The HTTP method we should use to call voice_fallback_url. Can be: GET or POST.

                          status_callback
                          オプション
                          post url Not PII

                          The URL we should call using the status_callback_method to send status information to your application.

                          status_callback_method
                          オプション
                          post http_method Not PII

                          The HTTP method we should use to call status_callback. Can be: GET or POST.

                          voice_caller_id_lookup
                          オプション
                          post boolean Not PII

                          Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: true or false.

                          sms_url
                          オプション
                          post url Not PII

                          The URL we should call when the phone number receives an incoming SMS message.

                          sms_method
                          オプション
                          post http_method Not PII

                          The HTTP method we should use to call sms_url. Can be: GET or POST.

                          sms_fallback_url
                          オプション
                          post url Not PII

                          The URL that we should call when an error occurs while retrieving or executing the TwiML from sms_url.

                          sms_fallback_method
                          オプション
                          post http_method Not PII

                          The HTTP method we should use to call sms_fallback_url. Can be: GET or POST.

                          sms_status_callback
                          オプション
                          post url Not PII

                          The URL we should call using a POST method to send status information about SMS messages sent by the application.

                          message_status_callback
                          オプション
                          post url Not PII

                          The URL we should call using a POST method to send message status information to your application.

                          例 1
                                
                                
                                
                                

                                Delete an Application resource

                                削除する
                                https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications/{Sid}.json

                                このアプリケーションを削除します。 IncoimngPhoneNumber リソースに、このアプリケーションの sid を VoiceApplicationSid または SmsApplicatonSid として割り当てている場合、このアプリケーションの sid は削除されます。

                                削除に成功すると、ボディーのない HTTP 204 レスポンスを返します。

                                パラメーター
                                Names in None format
                                account_sid
                                必須
                                削除する sid<AC> Not PII

                                The SID of the Account that created the Application resources to delete.

                                sid
                                必須
                                削除する sid<AP> Not PII

                                The Twilio-provided string that uniquely identifies the Application resource to delete.

                                例 1
                                      
                                      
                                      
                                      
                                      Rate this page:

                                      ヘルプが必要ですか?

                                      誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。