サービスリソース
A Service is the top-level scope of all other resources in Notify REST API.
You can create up to 10 Service resources per account and you can use them to:
- Create separate operational environments, such as dev, stage, and prod, all using the same Twilio account.
- Scope access to resources used by the Notify REST API
- Configure different behaviors of a push-notification or messaging service.
If you need more than 10 Service resources for your account, please contact support.
Service properties
| Resource Properties in REST API format | |
|---|---|
sid
|
The unique string that we created to identify the Service resource. |
account_sid
|
The SID of the Account that created the Service resource. |
friendly_name
|
The string that you assigned to describe the resource. |
date_created
|
The date and time in GMT when the resource was created specified in RFC 2822 format. |
date_updated
|
The date and time in GMT when the resource was last updated specified in RFC 2822 format. |
apn_credential_sid
|
The SID of the Credential to use for APN Bindings. |
gcm_credential_sid
|
The SID of the Credential to use for GCM Bindings. |
fcm_credential_sid
|
The SID of the Credential to use for FCM Bindings. |
messaging_service_sid
|
The SID of the Messaging Service to use for SMS Bindings. In order to send SMS notifications this parameter has to be set. |
facebook_messenger_page_id
|
Deprecated. |
default_apn_notification_protocol_version
|
The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_gcm_notification_protocol_version
|
The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_fcm_notification_protocol_version
|
The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
log_enabled
|
Whether to log notifications. Can be: |
url
|
The absolute URL of the Service resource. |
links
|
The URLs of the Binding, Notification, Segment, and User resources related to the service. |
alexa_skill_id
|
Deprecated. |
default_alexa_notification_protocol_version
|
Deprecated. |
delivery_callback_url
|
URL to send delivery status callback. |
delivery_callback_enabled
|
Callback configuration that enables delivery callbacks, default false |
Create a Service resource
https://notify.twilio.com/v1/Services
パラメーター
| Parameters in REST API format | |
|---|---|
friendly_name
オプション
|
A descriptive string that you create to describe the resource. It can be up to 64 characters long. |
apn_credential_sid
オプション
|
The SID of the Credential to use for APN Bindings. |
gcm_credential_sid
オプション
|
The SID of the Credential to use for GCM Bindings. |
messaging_service_sid
オプション
|
The SID of the Messaging Service to use for SMS Bindings. This parameter must be set in order to send SMS notifications. |
facebook_messenger_page_id
オプション
|
Deprecated. |
default_apn_notification_protocol_version
オプション
|
The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_gcm_notification_protocol_version
オプション
|
The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
fcm_credential_sid
オプション
|
The SID of the Credential to use for FCM Bindings. |
default_fcm_notification_protocol_version
オプション
|
The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
log_enabled
オプション
|
Whether to log notifications. Can be: |
alexa_skill_id
オプション
|
Deprecated. |
default_alexa_notification_protocol_version
オプション
|
Deprecated. |
delivery_callback_url
オプション
|
URL to send delivery status callback. |
delivery_callback_enabled
オプション
|
Callback configuration that enables delivery callbacks, default false |
例 1
Fetch a Service resource
https://notify.twilio.com/v1/Services/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Twilio-provided string that uniquely identifies the Service resource to fetch. |
例 1
Read multiple Service resources
https://notify.twilio.com/v1/Services
パラメーター
| Parameters in REST API format | |
|---|---|
friendly_name
オプション
|
The string that identifies the Service resources to read. |
例 1
Update a Service resource
https://notify.twilio.com/v1/Services/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Twilio-provided string that uniquely identifies the Service resource to update. |
friendly_name
オプション
|
A descriptive string that you create to describe the resource. It can be up to 64 characters long. |
apn_credential_sid
オプション
|
The SID of the Credential to use for APN Bindings. |
gcm_credential_sid
オプション
|
The SID of the Credential to use for GCM Bindings. |
messaging_service_sid
オプション
|
The SID of the Messaging Service to use for SMS Bindings. This parameter must be set in order to send SMS notifications. |
facebook_messenger_page_id
オプション
|
Deprecated. |
default_apn_notification_protocol_version
オプション
|
The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_gcm_notification_protocol_version
オプション
|
The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
fcm_credential_sid
オプション
|
The SID of the Credential to use for FCM Bindings. |
default_fcm_notification_protocol_version
オプション
|
The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
log_enabled
オプション
|
Whether to log notifications. Can be: |
alexa_skill_id
オプション
|
Deprecated. |
default_alexa_notification_protocol_version
オプション
|
Deprecated. |
delivery_callback_url
オプション
|
URL to send delivery status callback. |
delivery_callback_enabled
オプション
|
Callback configuration that enables delivery callbacks, default false |
例 1
Delete a Service resource
https://notify.twilio.com/v1/Services/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Twilio-provided string that uniquely identifies the Service 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 by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.