REST API: Application
Application インスタンス リソースは、ユーザーが Twilio で作成したアプリケーションを表現します。 Twilio 内部のアプリケーションは、ユーザーの Twilio 番号に通話や SMS が着信した時に Twilio がどのように振る舞うかを指示するための、URL とその他のコンフィグレーション データのセットです。 このコンフィグレーション データは、IncomingPhoneNumber リソースのコンフィグレーション データと同じです。つまり、VoiceUrl、VoiceMethod、VoiceFallbackUrl、VoiceFallbackMethod、StatusCallback、 StatusCallbackMethod、VoiceCallerIdLookup、SmsUrl、SmsMethod、SmsFallbackUrl、SmsFallbackMethod、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
|
The SID of the Account that created the Application resource. |
apiVersion
|
The API version used to start a new TwiML session. |
dateCreated
|
The date and time in GMT that the resource was created specified in RFC 2822 format. |
dateUpdated
|
The date and time in GMT that the resource was last updated specified in RFC 2822 format. |
friendlyName
|
The string that you assigned to describe the resource. |
messageStatusCallback
|
The URL we call using a POST method to send message status information to your application. |
sid
|
The unique string that that we created to identify the Application resource. |
smsFallbackMethod
|
The HTTP method we use to call |
smsFallbackUrl
|
The URL that we call when an error occurs while retrieving or executing the TwiML from |
smsMethod
|
The HTTP method we use to call |
smsStatusCallback
|
The URL we call using a POST method to send status information to your application about SMS messages that refer to the application. |
smsUrl
|
The URL we call when the phone number receives an incoming SMS message. |
statusCallback
|
The URL we call using the |
statusCallbackMethod
|
The HTTP method we use to call |
uri
|
The URI of the resource, relative to |
voiceCallerIdLookup
|
Whether we look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: |
voiceFallbackMethod
|
The HTTP method we use to call |
voiceFallbackUrl
|
The URL that we call when an error occurs retrieving or executing the TwiML requested by |
voiceMethod
|
The HTTP method we use to call |
voiceUrl
|
The URL we call when the phone number assigned to this application receives a call. |
Create an Application resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications.json
アカウント内で新しいアプリケーションを作成します。
リクエストが成功すると、Twilio は新しいアプリケーションの表現を返します。
パラメーター
| Names in None format | |
|---|---|
friendly_name
必須
|
A descriptive string that you create to describe the new application. It can be up to 64 characters long. |
api_version
オプション
|
The API version to use to start a new TwiML session. Can be: |
voice_url
オプション
|
The URL we should call when the phone number assigned to this application receives a call. |
voice_method
オプション
|
The HTTP method we should use to call |
voice_fallback_url
オプション
|
The URL that we should call when an error occurs retrieving or executing the TwiML requested by |
voice_fallback_method
オプション
|
The HTTP method we should use to call |
status_callback
オプション
|
The URL we should call using the |
status_callback_method
オプション
|
The HTTP method we should use to call |
voice_caller_id_lookup
オプション
|
Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: |
sms_url
オプション
|
The URL we should call when the phone number receives an incoming SMS message. |
sms_method
オプション
|
The HTTP method we should use to call |
sms_fallback_url
オプション
|
The URL that we should call when an error occurs while retrieving or executing the TwiML from |
sms_fallback_method
オプション
|
The HTTP method we should use to call |
sms_status_callback
オプション
|
The URL we should call using a POST method to send status information about SMS messages sent by the application. |
message_status_callback
オプション
|
The URL we should call using a POST method to send message status information to your application. |
account_sid
必須
|
The SID of the Account that will create the resource. |
例 1
Fetch an Application resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications/{Sid}.json
パラメーター
| Names in None format | |
|---|---|
account_sid
必須
|
The SID of the Account that created the Application resource to fetch. |
sid
必須
|
The Twilio-provided string that uniquely identifies the Application resource to fetch. |
例 1
Read multiple Application resources
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications.json
Application リソース表現のリストを返します。各項目は、アカウント内のアプリケーションを表現します。 このリストは ページ情報を含みます。
パラメーター
| Names in None format | |
|---|---|
friendly_name
オプション
|
The string that identifies the Application resources to read. |
account_sid
必須
|
The SID of the Account that created the Application resources to read. |
例 1
例 2
Update an Application resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications/{Sid}.json
アプリケーションのプロパティを更新します。更新に成功すると、更新されたリソース表現を返します。 返却されるレスポンスは、GET リクエストを送信した場合と同じです。
パラメーター
| Names in None format | |
|---|---|
account_sid
必須
|
The SID of the Account that created the Application resources to update. |
sid
必須
|
The Twilio-provided string that uniquely identifies the Application resource to update. |
friendly_name
オプション
|
A descriptive string that you create to describe the resource. It can be up to 64 characters long. |
api_version
オプション
|
The API version to use to start a new TwiML session. Can be: |
voice_url
オプション
|
The URL we should call when the phone number assigned to this application receives a call. |
voice_method
オプション
|
The HTTP method we should use to call |
voice_fallback_url
オプション
|
The URL that we should call when an error occurs retrieving or executing the TwiML requested by |
voice_fallback_method
オプション
|
The HTTP method we should use to call |
status_callback
オプション
|
The URL we should call using the |
status_callback_method
オプション
|
The HTTP method we should use to call |
voice_caller_id_lookup
オプション
|
Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: |
sms_url
オプション
|
The URL we should call when the phone number receives an incoming SMS message. |
sms_method
オプション
|
The HTTP method we should use to call |
sms_fallback_url
オプション
|
The URL that we should call when an error occurs while retrieving or executing the TwiML from |
sms_fallback_method
オプション
|
The HTTP method we should use to call |
sms_status_callback
オプション
|
The URL we should call using a POST method to send status information about SMS messages sent by the application. |
message_status_callback
オプション
|
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
必須
|
The SID of the Account that created the Application resources to delete. |
sid
必須
|
The Twilio-provided string that uniquely identifies the Application resource to delete. |
例 1
ヘルプが必要ですか？
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.