极光推送api

最新推荐文章于 2024-05-21 11:19:40 发布
最新推荐文章于 2024-05-21 11:19:40 发布
阅读量7k 收藏 3
点赞数

JPush iOS

jpush_ios

从上图可以看出，JPush iOS Push 包括 2 个部分，APNs 推送（代理），与 JPush 应用内消息。

红色部分是 APNs 推送，JPush 代理开发者的应用（需要基于开发者提供的应用证书），向苹果 APNs 服务器推送。由 APNs Server 推送到 iOS 设备上。

蓝色部分是 JPush 应用内推送部分，即 App 启动时，内嵌的 JPush SDK 会开启长连接到 JPush Server，从而 JPush Server 可以推送消息到 App 里。

APNs 通知

APNs 通知：是指通过向 Apple APNs 服务器发送通知，到达 iOS 设备，由 iOS 系统提供展现的推送。用户可以通过 IOS 系统的 “设置” >> “通知” 进行设置，开启或者关闭某一个 App 的推送能力。

JPush iOS SDK 不负责 APNs 通知的展现，只是向 JPush 服务器端上传 Device Token 信息，JPush 服务器端代理开发者向 Apple APNs 推送通知。

获取 APNs 推送内容

应用内消息

应用内消息：JPush iOS SDK 提供的应用内消息功能，在 App 在前台时能够收到推送下来的消息。App 可使用此功能来做消息下发动作。

此消息不经过 APNs 服务器，完全由 JPush 提供功能支持。

获取应用内消息推送内容

APNs通知与应用内消息对比

如果只需要发送通知，则可以忽略应用内消息的处理。对于两种消息的代码处理可以参考API 部分的描述。

JPush API v3 支持同时一次调用同时推送 APNs 通知与 JPush 应用内消息。这在某些应用场景里是有意义的。

  APNS 应用内消息
推送原则 由JPush服务器发送至APNS服务器，再下发到手机。 由JPush直接下发，每次推送都会尝试发送，如果用户在线则立即收到。否则保存为离线。
离线消息 离线消息由APNS服务器缓存按照Apple的逻辑处理。 用户不在线JPush server 会保存离线消息,时长默认保留一天。离线消息保留5条。
推送与证书环境 应用证书和推送指定的iOS环境匹配才可以收到。 自定义消息与APNS证书环境无关。
接收方式 应用退出，后台以及打开状态都能收到APNS 需要应用打开，与JPush 建立连接才能收到。
展示效果 如果应用后台或退出，会有系统的APNS提醒。

如果应用处于打开状态，则不展示。

 非APNS，默认不展示。可通过获取接口自行编码处理。
处理函数 Apple提供的接口：didReceiveRemoteNotification JPush提供的接口：networkDidReceiveMessage

iOS SDK 集成

请参考以下文档与教程，来集成 IOS SDK。

iOS SDK 说明

iOS 版本支持

  • 支持的iOS版本为6.0及以上版本。
  • 支持iOS版本为10.0以上的版本时需知。
    • Notification Service Extension证书配置时需要注意BundleID不能与Main Target一致，证书需要单独额外配置。
    • 请将Notification Service Extension中的Deployment Target设置为10.0。
    • 在XCode7或者更低的版本中删除Notification Service Extension所对应的Target。
    • 在XCode7或者更低的版本中请将引入的'UserNotifications.framework'删除。

组成

  • 头文件 JPUSHService.h
  • 静态库文件 jpush-ios-x.x.x.a，jcore-ios-x.x.x.a

注意事项

JPush APNs 通知的意义

iOS 平台上推送通知，只有 APNs 这个官方的通道，是可以随时送达的。一般开发者都是自己部署应用服务器向 APNs Server 推送。

JPush iOS 推送相比直接向 APNs 推送有什么好处呢？

  • 减少开发及维护成本：
    • 应用开发者不需要去开发维护自己的推送服务器与 APNs 对接。
    • 集成了 JPush iOS SDK 后不必自己维护更新 device token。
    • 通过 JPush 的 Web Portal 直接推送，也可以调用JPush的 HTTP 协议 API 来完成，开发工作量大大减少。
  • 减少运营成本：
    • 极光推送支持一次推送，同时向 Android, iOS, WinPhone 三个平台。支持统一的 API 与推送界面。
    • 极光推送提供标签、别名绑定机制，以及提供了非常细分的用户分群方式，运营起来非常简单、直观。
  • 提供应用内推送：
    • 除了使得 APNs 推送更简单，也另外提供应用内消息推送。这在类似于聊天的场景里很有必要。

JPush APNs 实现

JPush APNs 的实现可以参考极光博客的一篇文章：http://blog.jiguang.cn/apns/



Push API v3

这是 Push API 最近的版本。

相比于 API v2 版本，v3 版本的改进为：

  • 完全基于 https，不再提供 http 访问；
  • 使用 HTTP Basic Authentication 的方式做访问授权。这样整个 API 请求可以使用常见的 HTTP 工具来完成，比如：curl，浏览器插件等；
  • 推送内容完全使用 JSON 的格式；
  • 支持的功能有所改进：支持多 tag 的与或操作；可单独发送通知或者自定义消息，也可同时推送通知与自定义消息；windows phone 目前只有通知。

推送概述

功能说明

向某单个设备或者某设备列表推送一条通知、或者消息。
推送的内容只能是 JSON 表示的一个推送对象。

调用地址

POST https://api.jpush.cn/v3/push

请求示例

curl --insecure -X POST -v https://api.jpush.cn/v3/push -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{"platform":"all","audience":"all","notification":{"alert":"Hi,JPush !","android":{"extras":{"android-key1":"android-value1"}},"ios":{"sound":"sound.caf","badge":"+1","extras":{"ios-key1":"ios-value1"}}}}'

> POST /v3/push HTTP/1.1
> Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==

返回示例

< HTTP/1.1 200 OK
< Content-Type: application/json
{"sendno":"18","msg_id":"1828256757"}

调用验证

HTTP Header（头）里加一个字段（Key/Value对）：

Authorization: Basic base64_auth_string

其中 base64_auth_string 的生成算法为：base64(appKey:masterSecret)
即，对 appKey 加上冒号，加上 masterSecret 拼装起来的字符串，再做 base64 转换。

推送对象

一个推送对象，以 JSON 格式表达，表示一条推送相关的所有信息。

关键字 选项 含义
platform 必填 推送平台设置
audience 必填 推送设备指定
notification 可选 通知内容体。是被推送到客户端的内容。与 message 一起二者必须有其一，可以二者并存
message 可选 消息内容体。是被推送到客户端的内容。与 notification 一起二者必须有其一，可以二者并存
sms_message 可选 短信渠道补充送达内容体
options 可选 推送参数
cid 可选 用于防止 api 调用端重试造成服务端的重复推送而定义的一个标识符。

示例与说明

{
    "cid": "8103a4c628a0b98974ec1949-711261d4-5f17-4d2f-a855-5e5a8909b26e",
    "platform": "all",
    "audience": {
        "tag": [
            "深圳",
            "北京"
        ]
    },
    "notification": {
        "android": {
            "alert": "Hi, JPush!",
            "title": "Send to Android",
            "builder_id": 1,
            "extras": {
                "newsid": 321
            }
        },
        "ios": {
            "alert": "Hi, JPush!",
            "sound": "default",
            "badge": "+1",
            "extras": {
                "newsid": 321
            }
        }
    },
    "message": {
        "msg_content": "Hi,JPush",
        "content_type": "text",
        "title": "msg",
        "extras": {
            "key": "value"
        }
    },
    "sms_message":{
        "content":"sms msg content",
        "delay_time":3600
    },
    "options": {
        "time_to_live": 60,
        "apns_production": false,
        "apns_collapse_id":"jiguang_test_201706011100"
    }
}

platform：推送平台

JPush 当前支持 Android, iOS, Windows Phone 三个平台的推送。其关键字分别为："android", "ios", "winphone"。

如果目标平台为 iOS 平台 需要在 options 中通过 apns_production 字段来设定推送环境。True 表示推送生产环境，False 表示要推送开发环境； 如果不指定则为推送生产环境


推送到所有平台：

{ "platform" : "all" }

指定特定推送平台：

{ "platform" : ["android", "ios"] }

audience：推送目标

推送设备对象，表示一条推送可以被推送到哪些设备列表。确认推送设备对象，JPush 提供了多种方式，比如：别名、标签、注册ID、分群、广播等。

all

如果要发广播（全部设备），则直接填写 “all”。

推送目标

广播外的设备选择方式，有如下几种：

关键字 类型 含义 说明 备注
tag JSON Array 标签OR 数组。多个标签之间是 OR 的关系，即取并集。 用标签来进行大规模的设备属性、用户属性分群。 一次推送最多 20 个。
  • 有效的 tag 组成：字母（区分大小写）、数字、下划线、汉字、特殊字符@!#$&*+=.|￥。
  • 限制：每一个 tag 的长度限制为 40 字节。（判断长度需采用UTF-8编码）
tag_and JSON Array 标签AND 数组。多个标签之间是 AND 关系，即取交集。 注意与 tag 区分。一次推送最多 20 个。
tag_not JSON Array 标签NOT 数组。多个标签之间，先取多标签的并集，再对该结果取补集。 一次推送最多 20 个。
alias JSON Array 别名 数组。多个别名之间是 OR 关系，即取并集。 用别名来标识一个用户。一个设备只能绑定一个别名，但多个设备可以绑定同一个别名。一次推送最多 1000 个。
  • 有效的 alias 组成：字母（区分大小写）、数字、下划线、汉字、特殊字符@!#$&*+=.|￥。
  • 限制：每一个 alias 的长度限制为 40 字节。（判断长度需采用UTF-8编码）
registration_id JSON Array 注册ID 数组。多个注册ID之间是 OR 关系，即取并集。 设备标识。一次推送最多 1000 个。
segment JSON Array 用户分群ID 在页面创建的用户分群的 ID。定义为数组，但目前限制一次只能推送一个。 目前限制是一次只能推送一个。
abtest JSON Array A/B Test ID 在页面创建的 A/B 测试的 ID。定义为数组，但目前限制是一次只能推送一个。 目前限制一次只能推送一个。


以上几种类型至少需要有其一。如果值数组长度为 0，表示该类型不存在。

这几种类型可以并存，多项的隐含关系是 AND，即取几种类型结果的交集。

例如：

先计算 tag 中字段 tag1 和 tag2 的结果 tag1或tag2=A;

再计算 tag_and 中字段 tag3 和 tag4 的结果 tag3且tag4=B;

再计算 tag_not 中字段 tag5 和 tag6 的结果 非(tag5或tag6)=C 。

最终的结果为 A且B且C 。


示例

  • 推送给全部（广播）：
{
   "platform": "all",
   "audience" : "all",
   "notification" : {
      "alert" : "Hi, JPush!",
      "android" : {}, 
      "ios" : {
         "extras" : { "newsid" : 321}
      }
   }
}
  • 推送给多个标签（只要在任何一个标签范围内都满足）：在深圳、广州、或者北京
{
    "audience" : {
        "tag" : [ "深圳", "广州", "北京" ]
    }
}
  • 推送给多个标签（需要同时在多个标签范围内）：在深圳并且是“女”
{
    "audience" : {
        "tag_and" : [ "深圳", "女" ]
    }
}
  • 推送给多个别名：
{
    "audience" : {
        "alias" : [ "4314", "892", "4531" ]
    }
}
  • 推送给多个注册ID：
{
    "audience" : {
        "registration_id" : [ "4312kjklfds2", "8914afd2", "45fdsa31" ]
    }
}
  • 可同时推送指定多类推送目标：在深圳或者广州，并且是 “女” “会员”
{
    "audience" : {
        "tag" : [ "深圳", "广州" ]
        "tag_and" : [ "女", "会员"]
    }
}

notification：通知

“通知”对象，是一条推送的实体内容对象之一（另一个是“消息”），是会作为“通知”推送到客户端的。
其下属属性包含 4 种，3 个平台属性，以及一个 "alert" 属性。

alert

通知的内容在各个平台上，都可能只有这一个最基本的属性 "alert"。
这个位置的 "alert" 属性（直接在 notification 对象下），是一个快捷定义，各平台的 alert 信息如果都一样，则可不定义。如果各平台有定义，则覆盖这里的定义。

{
    "notification" : {
        "alert" : "Hello, JPush!"
    }
}

上面定义的 notification 对象，将被推送到 "platform" 指定的多个平台，并且其通知 alert 信息都一样。

android

Android 平台上的通知，JPush SDK 按照一定的通知栏样式展示。

支持的字段有：

关键字 类型 选项 含义 说明
alert string 必填 通知内容 这里指定了，则会覆盖上级统一指定的 alert 信息；内容可以为空字符串，则表示不展示到通知栏。
title string 可选 通知标题 如果指定了，则通知里原来展示 App名称的地方，将展示成这个字段。
builder_id int 可选 通知栏样式ID Android SDK 可设置通知栏样式，这里根据样式 ID 来指定该使用哪套样式。
priority int 可选 通知栏展示优先级 默认为0，范围为 -2～2 ，其他值将会被忽略而采用默认。
category string 可选 通知栏条目过滤或排序 完全依赖 rom 厂商对 category 的处理策略
style int 可选 通知栏样式类型 默认为0，还有1，2，3可选，用来指定选择哪种通知栏样式，其他值无效。有三种可选分别为bigText=1，Inbox=2，bigPicture=3。
alert_type int 可选 通知提醒方式 可选范围为 -1 ～ 7 ，对应 Notification.DEFAULT_ALL = -1 或者 Notification.DEFAULT_SOUND = 1, Notification.DEFAULT_VIBRATE = 2, Notification.DEFAULT_LIGHTS = 4 的任意 “or” 组合。默认按照 -1 处理。
big_text string 可选 大文本通知栏样式 当 style = 1 时可用，内容会被通知栏以大文本的形式展示出来。支持 api 16以上的rom。
inbox JSONObject 可选 文本条目通知栏样式 当 style = 2 时可用， json 的每个 key 对应的 value 会被当作文本条目逐条展示。支持 api 16以上的rom。
big_pic_path string 可选 大图片通知栏样式 当 style = 3 时可用，可以是网络图片 url，或本地图片的 path，目前支持.jpg和.png后缀的图片。图片内容会被通知栏以大图片的形式展示出来。如果是 http／https 的url，会自动下载；如果要指定开发者准备的本地图片就填sdcard 的相对路径。支持 api 16以上的rom。
extras JSON Object 可选 扩展字段 这里自定义 JSON 格式的 Key/Value 信息，以供业务使用。


{
    "notification" : {
        "android" : {
             "alert" : "hello, JPush!", 
             "title" : "JPush test", 
             "builder_id" : 3, 
             "style":1  // 1,2,3
             "alert_type":1 // -1 ~ 7
             "big_text":"big text content",
             "inbox":JSONObject,
             "big_pic_path":"picture url",
             "priority":0, // -2~2
             "category":"category str",
             "extras" : {
                  "news_id" : 134, 
                  "my_key" : "a value"
             }
        }
    }
}

iOS

iOS 平台上 APNs 通知结构。
该通知内容会由 JPush 代理发往 Apple APNs 服务器，并在 iOS 设备上在系统通知的方式呈现。
该通知内容满足 APNs 的规范，支持的字段如下：

关键字 类型 选项 含义 说明
alert string或JSON Object 必填 通知内容 这里指定内容将会覆盖上级统一指定的 alert 信息；内容为空则不展示到通知栏。支持字符串形式也支持官方定义的alert payload 结构
sound string 可选 通知提示声音 如果无此字段，则此消息无声音提示；有此字段，如果找到了指定的声音就播放该声音，否则播放默认声音,如果此字段为空字符串，iOS 7 为默认声音，iOS 8及以上系统为无声音。(消息) 说明：JPush 官方 API Library (SDK) 会默认填充声音字段。提供另外的方法关闭声音。
badge int 可选 应用角标 如果不填，表示不改变角标数字；否则把角标数字改为指定的数字；为 0 表示清除。JPush 官方 API Library(SDK) 会默认填充badge值为"+1",详情参考：badge +1
content-available boolean 可选 推送唤醒 推送的时候携带"content-available":true 说明是 Background Remote Notification，如果不携带此字段则是普通的Remote Notification。详情参考：Background Remote Notification
mutable-content boolean 可选 通知扩展 推送的时候携带”mutable-content":true 说明是支持iOS10的UNNotificationServiceExtension，如果不携带此字段则是普通的Remote Notification。详情参考：UNNotificationServiceExtension
category string 可选   IOS8才支持。设置APNs payload中的"category"字段值
extras JSON Object 可选 附加字段 这里自定义 Key/value 信息，以供业务使用。


iOS 通知 JPush 要转发给 APNs 服务器。APNs 协议定义通知长度为 2048 字节。

JPush 因为需要重新组包，并且考虑一点安全冗余，要求"iOS":{ } 及大括号内的总体长度不超过：2000 个字节。JPush 使用 utf-8 编码，所以一个汉字占用 3 个字节长度。



服务端发送消息串

{
    "notification" : {
         "ios" : {
                 "alert" : "hello, JPush!", 
                 "sound" : "sound.caf", 
                 "badge" : 1, 
                 "extras" : {
                      "news_id" : 134, 
                      "my_key" : "a value"
                 }
            }
       }
}

客户端收到apns

{
    "_j_msgid" = 813843507;
    aps =     {
        alert = "hello,JPush!";
        badge = 1;
        sound = "sound.caf";
    };
    "my_key" = "a value";
    "news_id" = 134;
}

winphone

Windows Phone 平台上的通知。
该通知由 JPush 服务器代理向微软的 MPNs 服务器发送，并在 Windows Phone 客户端的系统通知栏上展示。
该通知满足 MPNs 的相关规范。当前 JPush 仅支持 toast 类型：

关键字 类型 选项 含义 说明
alert string 必填 通知内容 会填充到 toast 类型 text2 字段上。这里指定了，将会覆盖上级统一指定的 alert 信息；内容为空则不展示到通知栏。
title string 可选 通知标题 会填充到 toast 类型 text1 字段上。
_open_page string 可选 点击打开的页面名称 点击打开的页面。会填充到推送信息的 param 字段上，表示由哪个 App 页面打开该通知。可不填，则由默认的首页打开。
extras JSON Object 可选 扩展字段 作为参数附加到上述打开页面的后边。


    {
        "notification" : {
            "winphone" : {
                 "alert" : "hello, JPush!", 
                 "title" : "Push Test", 
                 "_open_page" : "/friends.xaml", 
                 "extras" : {
                      "news_id" : 134, 
                      "my_key" : "a value"
                 }
            }
        }
    }

message：自定义消息

应用内消息。或者称作：自定义消息，透传消息。
此部分内容不会展示到通知栏上，JPush SDK 收到消息内容后透传给 App。需要 App 自行处理。
iOS 平台上，此部分内容在推送应用内消息通道（非APNS）获取。Windows Phone 暂时不支持应用内消息。

消息包含如下字段：

关键字 类型 选项 含义
msg_content string 必填 消息内容本身
title string 可选 消息标题
content_type string 可选 消息内容类型
extras JSON Object 可选 JSON 格式的可选参数


Android 1.6.2及以下版本 接收notification 与message并存（即本次api调用同时推送通知和消息）的离线推送， 只能收到通知部分，message 部分没有透传给 App。

Android 1.6.3及以上SDK 版本已做相应调整，能正常接收同时推送通知和消息的离线记录。

iOS 1.7.3及以上的版本才能正确解析v3的message，但是无法解析v2推送通知同时下发的应用内消息。

sms_message：短信补充

温馨提示：

使用短信业务，会产生额外的运营商费用，具体请咨询商务，联系电话：400-612-5955 商务QQ：800024881


用于设置短信推送内容以及短信发送的延迟时间。手机接收号码,开发者需要先把用户的手机号码与设备的registration id匹配。绑定方法：服务端-Device-更新设备

与原有 JSON 业务协议相匹配，消息有如下字段信息：

关键字 类型 选项 示例
content string 必填 不能超过480个字符。"你好,JPush"为8个字符。70个字符记一条短信费，如果超过70个字符则按照每条67个字符拆分，逐条计费。单个汉字、标点、英文都算一个字。
delay_time int 必填 单位为秒，不能超过24小时。设置为0，表示立即发送短信。该参数仅对android平台有效，iOS 和 Winphone平台则会立即发送短信

options：可选参数

推送可选项。

当前包含如下几个可选项：

关键字 类型 选项 含义 说明
sendno int 可选 推送序号 纯粹用来作为 API 调用标识，API 返回时被原样返回，以方便 API 调用方匹配请求与返回。
time_to_live int 可选 离线消息保留时长(秒) 推送当前用户不在线时，为该用户保留多长时间的离线消息，以便其上线时再次推送。默认 86400 （1 天），最长 10 天。设置为 0 表示不保留离线消息，只有推送当前在线的用户可以收到。
override_msg_id long 可选 要覆盖的消息ID 如果当前的推送要覆盖之前的一条推送，这里填写前一条推送的 msg_id 就会产生覆盖效果，即：1）该 msg_id 离线收到的消息是覆盖后的内容；2）即使该 msg_id Android 端用户已经收到，如果通知栏还未清除，则新的消息内容会覆盖之前这条通知；覆盖功能起作用的时限是：1 天。如果在覆盖指定时限内该 msg_id 不存在，则返回 1003 错误，提示不是一次有效的消息覆盖操作，当前的消息不会被推送。
apns_production boolean 可选 APNs是否生产环境 True 表示推送生产环境，False 表示要推送开发环境；如果不指定则为推送生产环境。JPush 官方 API LIbrary (SDK) 默认设置为推送 “开发环境”。
apns_collapse_id string 可选 更新 iOS 通知的标识符 APNs 新通知如果匹配到当前通知中心有相同 apns-collapse-id 字段的通知，则会用新通知内容来更新它，并使其置于通知中心首位。collapse id 长度不可超过 64 bytes。
big_push_duration int 可选 定速推送时长(分钟) 又名缓慢推送，把原本尽可能快的推送速度，降低下来，给定的n分钟内，均匀地向这次推送的目标用户推送。最大值为1400.未设置则不是定速推送。

cid: 推送唯一标识符

调用地址

GET https://api.jpush.cn/v3/push/cid[?count=n[&type=xx]]

功能说明

cid 是用于防止 api 调用端重试造成服务端的重复推送而定义的一个推送参数。

用户使用一个 cid 推送后，再次使用相同的 cid 进行推送，则会直接返回第一次成功推送的结果，不会再次进行推送。

CID的有效期为1天。CID的格式为：{appkey}-{uuid}

在使用cid之前，必须通过接口获取你的 cid 池。获取时type=push或者不传递type值。

调用示例

Request Header
curl --insecure -X GET -v https://api.jpush.cn/v3/push/cid?count=3 -H "Content-Type: application/json" -u "2743204aad6fe2572aa2d8de:e674a3d0fd42a53b9a58121c"

GET /v3/push/cid?count=3
Authorization: Basic (base64 auth string)
Content-Type: text/plain
Accept: application/json
Request Params
count
    可选参数。数值类型，不传则默认为1。范围为[1, 1000]
type
    可选参数。CID类型。取值：push(默认), schedule
Response Header
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

 Response Data  

{
 "cidlist":[
 "8103a4c628a0b98994ec1949-128eeb45-471c-49f3-b442-a05c20c9ed56",
 "8103a4c628a0b98994ec1949-6e44d7f1-89f5-48a8-bec4-e359c15b13e5",
 "8103a4c628a0b98994ec1949-47e0a960-ce67-4e71-94ce-b4b9e8813af0"
 ]
}
Response Params
cidlist
    cid列表

Group Push API: 应用分组推送

调用地址

POST https://api.jpush.cn/v3/grouppush

功能说明

该 API 用于为开发者在 portal 端创建的应用分组创建推送。 groupkey 可以在创建的分组信息中获取，使用起来同 appkey 类似，但在使用的时候前面要加上 “group-” 前缀。

注：暂不支持 option 中 override_msg_id 的属性。

调用示例

curl --insecure -X POST -v https://api.jpush.cn/v3/grouppush -H "Content-Type: application/json" -u "group-e4c938578ee598be517a2243:71d1dc4dae126674ed386b7b" -d '{"platform":["android"],"audience":"all","notification":{"android":{"alert":"notification content","title":"notification title"}},"message":{"msg_content":"message content"}}'

推送校验 API

调用地址

POST https://api.jpush.cn/v3/push/validate

功能说明

该 API 只用于验证推送调用是否能够成功，与推送 API 的区别在于：不向用户发送任何消息。 其他字段说明：同推送 API。

调用返回

Code 描述 详细解释 HTTP Status Code
1000 系统内部错误 服务器端内部逻辑错误，请稍后重试。 500
1001 只支持 HTTP Post 方法 不支持 Get 方法。 405
1002 缺少了必须的参数 必须改正 400
1003 参数值不合法 必须改正。参数不合法的情况如：Audience参数中tag，alias，registration_id有空值；单发指定的 registration_id 非法或者格式错误。 400
1004 验证失败 必须改正。详情请看：调用验证 401
1005 消息体太大 必须改正。 Android平台Notification+Message长度限制为4000字节； iOS Notification 中 “iOS”:{ } 及大括号内的总体长度不超过：2000个字节（包括自定义参数和符号），iOS 的 Message部分长度不超过 4000 字节； WinPhone平台Notification长度限制为1000字节 400
1008 app_key参数非法 必须改正 400
1009 推送对象中有不支持的key 必须改正 400
1011 没有满足条件的推送目标 请检查audience 400
1020 只支持 HTTPS 请求 必须改正 404
1030 内部服务超时 稍后重试 503
2002 API调用频率超出该应用的限制 联系极光商务或技术支持开通更高的 API 调用频率 429
2003 该应用appkey已被限制调用 API 联系技术支持查明限制原因和寻求帮助 403
2004 无权限执行当前操作 必须改正。当前调用 API 的源 ip 地址不在该应用的 ip 白名单中。 403
2005 信息发送量超出合理范围。 检测到目标用户累计发送消息量过大，超过合理的使用范围，需要检查业务逻辑或者联系技术支持。 403

参考

麦晓宇
关注
  • 0
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
极光推送java调用_java远程调用JPush极光推送Api
weixin_30613239的博客
02-15 459
调用JPush推送的api，官网上已经有很详细的说明了。这里主要描述一下我在调用过程中遇到的问题，比如我的HttpClient不支持https的请求、参数配置错误 和 验证错误等等。开发的时候需要引用appache的包commons-httpclient.jar 、commons-codec.jar、commons-logging.jar这些包可以到官网上下载，如果有需要的话也我也可以发给你。引入...
Android 极光推送API
2401_84009215的博客
05-03 655
以下是资料目录和内容部分截图里面包括详细的知识点讲解分析，带你一个星期入门Flutter。还有130个进阶学习项目实战视频教程，让你秒变大前端。《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》点击传送门，即可获取！//设置自定义消息if (null!//是否开启通知接收try {以下是资料目录和内容部分截图[外链图片转存中…(img-71gRmF1B-1714688040603)]
邮件推送API接口与其他API接口的对比分析？
Aoksend的博客
05-21 553
邮件推送API接口与其他API接口在多方面都存在一些差异。AokSend，利用API/SMTP接口，邮件推送API接口一触即发，高效营销，让您的信息瞬间触达全球！
极光推送 java api_JPush极光推送Java服务器端API
weixin_39705931的博客
02-15 136
方法名称参数列表(必须)方法说明setEnableSSLboolean enableSSL (true为使用ssl, 默认为不使用ssl)是否启动ssl安全连接sendNotificationWithImeiint sendNo(发送编号),String imei (IMEI字符串) ,String msgTitle (消息标题/通知标题),String msgContent (消息内容/通知内...
Android极光推送 API简述
joh_hz的博客
06-28 1577
上一篇文章讲述了极光推送的 jcenter 自动集成，简单快捷，本篇简单介绍一下极光推送API在实际项目中的经常使用的一些方法。 1.设置调试模式 JPushInterface.setDebugMode(isDebug); 在自定义的Application中onCreate中调用,用于debug调试，正式环境不用调用。 2.初始化 JPushInterface.init(...
极光推送REST API与Java后台对接
一只没有脚的鸟
01-17 1443
极光推送Java后台对接
极光推送-服务端API开发
Kevin_ASL的博客
09-15 1081
极光推送-服务端开发 参数: https://docs.jiguang.cn https://community.jiguang.cn REST API 基本约束 API 被设计为符合HTTP,REST规范.例如:查询请求使用GET方法;提交请求使用POST请求. API 资源列表 描述 资源 URL 推送消息API POST /v3/push https://api.jp...
Python 手机端自动推送功能（利用极光推送API）
silencehhh的博客
04-26 5331
Python+Jpush手机端信息推送 极光推送API是一种开发者服务，这里不再赘述 我们在官网申请账号，创建应用，这里官方有详细的文档描述，这里也不再赘述，下图是我创建好的应用。 我们打开自己 的应用，重点是找到自己应用的app_key和自己的Master Secre 再次点击侧面栏的推送设置，选择自己的推送设备，比如我的是安卓的，会看到下图式样 初次使用是需要设置包名，这...
极光推送API
weixin_30312557的博客
11-22 83
https://github.com/jpush/jpush-api-ruby-client/blob/master/docs/Guides.md#%E6%9B%B4%E6%96%B0%E8%AE%BE%E5%A4%87-%E8%AE%BE%E5%A4%87%E7%9A%84%E5%88%AB%E5%90%8D%E4%B8%8E%E6%A0%87%E7%AD%BE 转载于:https://www....
【解决】极光推送API推送，ios推送失败，目标数为0
重诺，守时。
11-04 3024
极光推送分为web推送与api推送两种方式，web推送即通过极光后台给设备推送，一般推送不针对单个用户的消息，比如：欢迎参加xx活动。而api则一般推送包含变量的消息，如：{xx用户}提现{xx金额}已到账！ 同时，web与api的推送的目标平台有四种，分别为：Android，ios开发环境，ios生产环境，WinPhone四种。 场景 集成了官方文档中提供的服务端SDK库（PHP），在通过api...
极光推送API后端代码
04-09
极光推送后端API代码，用于推送发送接收极光推送消息
极光推送java端API
12-18
Java端API则是开发者在服务器端进行极光推送操作的重要接口，它提供了丰富的功能，包括但不限于创建推送、管理设备标签、获取推送报告等。 1. **API接口** 极光推送Java API提供了多种接口供开发者调用，如创建推...
java接入极光推送demo
05-28
在这个"java接入极光推送demo"中，我们将探讨如何使用Java API客户端来实现这一功能。 首先，我们需要了解JPush API Java客户端，它是极光提供的一个Java库，用于与极光推送服务器进行交互。这个库提供了各种接口，...
2024浙江省行政区划矢量图层-省市县乡镇四级行政区划数据下载-带python代码
最新发布
08-02
2024最新浙江省行政区划矢量图层数据，包含省、市、县、乡镇四级行政区划数据下载，附带shp转geojson的python代码
年度销售计划表.xlsx.xlsx
08-01
销售统计，调查问卷，库存明细，跟进表，业绩统计表，差异分析 ，产品清单 适用人群：学习不同技术领域的小白或进阶学习者；可作为毕设项目、课程设计、大作业、工程实训或初期项目立项。
蓝牙BLE 4.0开发课程
08-01
蓝牙BLE 4.0课程
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值