SIP Domain Resource
A SIP Domain resource describes a custom DNS hostname that can accept SIP traffic for your account. A SIP request to that domain, such as to sip:alice@example.sip.twilio.com, routes to Twilio. Twilio authenticates the request and requests TwiML from the voice_url of the SIP Domain.
SIP Domain Authentication
Your SIP Domain must map at least one of these two authentication methods or requests to it will be blocked.
SipDomain properties
| Names in PHP format | |
|---|---|
accountSid
|
The SID of the Account that created the SipDomain resource. |
apiVersion
|
The API version used to process the call. |
authType
|
The types of authentication you have mapped to your domain. Can be: |
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. |
domainName
|
The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and "-". |
friendlyName
|
The string that you assigned to describe the resource. |
sid
|
The unique string that that we created to identify the SipDomain resource. |
uri
|
The URI of the resource, relative to |
voiceFallbackMethod
|
The HTTP method we use to call |
voiceFallbackUrl
|
The URL that we call when an error occurs while retrieving or executing the TwiML requested from |
voiceMethod
|
The HTTP method we use to call |
voiceStatusCallbackMethod
|
The HTTP method we use to call |
voiceStatusCallbackUrl
|
The URL that we call to pass status parameters (such as call ended) to your application. |
voiceUrl
|
The URL we call using the |
subresourceUris
|
A list of mapping resources associated with the SIP Domain resource identified by their relative URIs. |
sipRegistration
|
Whether to allow SIP Endpoints to register with the domain to receive calls. |
Create a SipDomain resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains.json
パラメーター
| Names in None format | |
|---|---|
domain_name
必須
|
The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and "-". |
friendly_name
オプション
|
A descriptive string that you created to describe the resource. It can be up to 64 characters long. |
voice_url
オプション
|
The URL we should when the domain 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 while retrieving or executing the TwiML from |
voice_fallback_method
オプション
|
The HTTP method we should use to call |
voice_status_callback_url
オプション
|
The URL that we should call to pass status parameters (such as call ended) to your application. |
voice_status_callback_method
オプション
|
The HTTP method we should use to call |
sip_registration
オプション
|
Whether to allow SIP Endpoints to register with the domain to receive calls. Can be |
account_sid
必須
|
The SID of the Account that will create the resource. |
例 1
Fetch a SipDomain resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains/{Sid}.json
パラメーター
| Names in None format | |
|---|---|
account_sid
必須
|
The SID of the Account that created the SipDomain resource to fetch. |
sid
必須
|
The Twilio-provided string that uniquely identifies the SipDomain resource to fetch. |
例 1
Read multiple SipDomain resources
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains.json
パラメーター
| Names in None format | |
|---|---|
account_sid
必須
|
The SID of the Account that created the SipDomain resources to read. |
例 1
Update a SipDomain resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains/{Sid}.json
パラメーター
| Names in None format | |
|---|---|
account_sid
必須
|
The SID of the Account that created the SipDomain resource to update. |
sid
必須
|
The Twilio-provided string that uniquely identifies the SipDomain resource to update. |
friendly_name
オプション
|
A descriptive string that you created to describe the resource. It can be up to 64 characters long. |
voice_fallback_method
オプション
|
The HTTP method we should use to call |
voice_fallback_url
オプション
|
The URL that we should call when an error occurs while retrieving or executing the TwiML requested by |
voice_method
オプション
|
The HTTP method we should use to call |
voice_status_callback_method
オプション
|
The HTTP method we should use to call |
voice_status_callback_url
オプション
|
The URL that we should call to pass status parameters (such as call ended) to your application. |
voice_url
オプション
|
The URL we should call when the domain receives a call. |
sip_registration
オプション
|
Whether to allow SIP Endpoints to register with the domain to receive calls. Can be |
domain_name
オプション
|
The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and "-". |
例 1
Delete a SipDomain resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains/{Sid}.json
パラメーター
| Names in None format | |
|---|---|
account_sid
必須
|
The SID of the Account that created the SipDomain resources to delete. |
sid
必須
|
The Twilio-provided string that uniquely identifies the SipDomain 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.