The CreateChannel API allows the Account Owner to create a channel for sending push notifications to a particular mobile application. The operation may only be called over HTTPS.
Apstrata allows a developer to send push notifications to iOS applications by abstracting the Apple Push Notification Service. Similarly, it allows a developer to send push notifications to Android applications by abstracting the Google Cloud Messaging for Android. In other words, apstrata serves as a push notifications provider for iOS and Andriod applications.
Apstrata makes it really simple to enable push notifications for your applications through a REST API. Here are the steps that need to be taken for this purpose:
- Create a configuration for a "mobile application" using the "AddCertificate" API (upload the required certificate and password as both Apple and Google require that push notifications requests be authenticated).
- Create channels and subscribe device tokens to them (every device has a unique token or identifier) or push notifications to a run-time specified set of devices ("ad-hoc")
- Send notifications to a channel (push notifications will be sent to all devices subscribed in the channel) or to the ad-hoc set of tokens
Both Apple and Google require that push notifications requests to a certain application be authenticated. Please check AddCertificate API for more details on that.
Specific Request Parameters
(Refer to Common Request Parameters)
The name of the store in which the channel is created.
|channelId||A unique identifier for the channel.||Yes|
The platform for which the channel is created.
|applicationID||An identifier for the mobile application at hand. It is recommended to use you domain name in the application ID so as to make it as unique as possible.||Yes|
A parameter containing the device tokens or identifiers to be subscribed in the created channel. To send more than one device token, you need to send this parameter more than once, each time with a specific device token.
There is a limit to the amount of device tokens that can be subscribed to a channel.
|lifetime||The duration (in seconds) after which the notification expires.||No||5 seconds|
Specific Response Elements
(Refer to Common Response Elements)
Specific Logical Errors
(Refer to Common Logical Error Codes)
Store name is invalid.
The store was not found
|PARAMETER_REQUIRED||One of the required parameters is missing||400|
|INVALID_REQUEST||The request is made over HTTP and not HTTPS||400|
|PERMISSION_DENIED||The request is made by a regular user and not by the account owner||403|
|DUPLICATE_DOCUMENT_KEY||The provided channelId already exists||400|
|INVALID_PARAMETER||The value provided for the platform parameter is not valid or is not supported, or a the limit of tokens has been reached||400|
Sample XML Response
Sample JSON Response