MassPushV2
Pushes notifications in batch by using the advanced push API V2.
Operation description
Before using this operation, make sure that you fully understand the billing method and pricing of EMAS Mobile Push.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
mpush:MassPushV2 |
none |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AppKey |
integer |
Yes |
The AppKey information. |
23267*** |
| IdempotentToken |
string |
No |
An idempotent parameter used to prevent duplicate pushes caused by API call retries on the client side. If the same IdempotentToken is used for calls within 15 minutes, only one push is performed, and subsequent calls return the result of the first successful push. Note
|
c8016d13-6e76-****-9bda-769383d11787 |
| PushTasks |
array |
Yes |
The batch push tasks. |
|
| PushTask |
No |
The push task. |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
159E4422-6624-****-8943-DFD98D34858C |
| MessageIds |
array |
The list of message IDs. |
|
|
string |
The message ID. |
1091371886864**** |
Examples
Success response
JSON format
{
"RequestId": "159E4422-6624-****-8943-DFD98D34858C",
"MessageIds": [
"1091371886864****"
]
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidPeriod.ExceedDays | The period between specified EndTime and StartTime exceeds %s days. | |
| 400 | Invalid%s.Format | The specified %s format is invalid. | |
| 400 | AccountDisabled | Your account is not enabled. | |
| 400 | FileNotExist | The specified file does not exist. | |
| 400 | IncorrectPassword | The password is incorrect. | |
| 400 | NotApnsCertificate | The Certificate is not an APNs certificate. | |
| 400 | PermissionDenied | The specified AppKey is not authorized. | |
| 400 | SendSpeedNotSupported | SendSpeed is not supported for specified Target. | |
| 400 | SmsProfileConfigFailed | Failed to configure SMS profile. | |
| 400 | SmsProfileGetFailed | Failed to get SMS profile. | |
| 400 | SmsRoleAuthorizeFailed | Failed to authorize SMS role. | |
| 400 | SmsRoleUnauthorized | The SMS role is unauthorized. | |
| 400 | TagsNumberBeyondLimit | The number of tags bound to this app exceeds the limit. | |
| 400 | Invalid%s.LengthExceed | The specified %s length cannot be greater than %s. | |
| 400 | Invalid%s.BytesExceed | The specified %s exceeds the %s bytes limit. | |
| 400 | Invalid%s.Empty | The specified %s cannot be empty. | |
| 400 | Invalid.Parameter | The specified parameter is invalid: %s. | |
| 400 | TargetNotSupported | Target is not supported for batch push. | |
| 500 | InternalError | The request processing has failed due to some unknown error. Please try again. If the error still exists, submit a ticket. | The request processing has failed due to some unknown error. |
| 500 | Timeout | The request processing is timeout. | Request processing timed out. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.