高级推送接口V2。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| AppKey | long | 是 | AppKey 信息 | 23267*** |
| IdempotentToken | string | 否 | 用于防止 API 调用端重试造成服务端重复推送的一个幂等参数。15 分钟内使用相同 IdempotentToken 进行调用时，只会进行一次推送，后续返回第一次成功推送的结果。 说明
| c8016d13-6e76-****-9bda-769383d11787 |
| PushTasks | array | 是 | 批量推送任务 | |
| PushTask | 是 | 推送任务 |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "159E4422-6624-****-8943-DFD98D34858C",
"MessageIds": [
"1091371886864****"
]
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidPeriod.ExceedDays | The period between specified EndTime and StartTime exceeds %s days. | 开始时间和结束时间超过%s天。 |
| 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. | 不是APNs证书。 |
| 400 | PermissionDenied | The specified AppKey is not authorized. | 您没有访问该app的权限，请您检查Appkey参数是否属于该账户。 |
| 400 | SendSpeedNotSupported | SendSpeed is not supported for specified Target. | 制定目标不支持SendSpeed参数。 |
| 400 | SmsProfileConfigFailed | Failed to configure SMS profile. | SMS配置失败。 |
| 400 | SmsProfileGetFailed | Failed to get SMS profile. | SMS配置获取失败。 |
| 400 | SmsRoleAuthorizeFailed | Failed to authorize SMS role. | SMS角色授权失败。 |
| 400 | SmsRoleUnauthorized | The SMS role is unauthorized. | SMS角色没有授权。 |
| 400 | TagsNumberBeyondLimit | The number of tags bound to this app exceeds the limit. | 当前app绑定的tag数量超过限制。 |
| 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. | 参数%s无效。 |
| 400 | TargetNotSupported | Target is not supported for batch push. | 批量推送不支持的Target。 |
| 400 | TargetNotSupported | Target is not supported for file push. | 文件推送不支持的Target。 |
| 400 | TargetNotSupported | Target is not supported for iOS live activity. | iOS灵动岛推送不支持的target |
| 500 | InternalError | The request processing has failed due to some unknown error. Please try again. If the error still exists, submit a ticket. | 服务端错误，建议重试，仍然失败则提工单 |
| 500 | Timeout | The request processing is timeout. | 请求处理超时。 |
访问错误中心查看更多错误码。