友盟使用文档.docVIP

友盟消息推送服务器端API V1.0指南 1 概述1.1 基本说明 本文所描述的API接口均基于HTTP Rest协议, 若无特殊说明接口均使用UTF-8编码, 消息体参数以及返回结果均采用Json格式。注意: 使用API前需要在Web后台获取 appkey 和 app_master_secret，同时在web后台添加 服务器IP地址 做IP白名单过滤。1.2 基本概念appkey：应用唯一标识?app_master_secret：服务器Key。?device_token: 友盟后台对设备的唯一标识。注意, Android的device_token是44位字符串, iOS的device-token是64位。单播: 向指定的设备发送消息。广播: 向安装该APP的所有设备发送消息。组播: 向满足特定条件的设备集合发送消息，例如: 特定版本、特定地域等。alias: 第三方账号, 开发者可以在SDK中调用setAlias接口，SDK会把设定的alias,alias_type与device_token进行绑定传回到后端。便于开发者通过自有业务逻辑筛选出alias，通过发送alias给友盟进行消息推送。?通知-Android: 消息送达到用户设备后，由友盟处理内容并在通知栏上显示通知内容。消息-Android: 消息送达到用户设备后，消息内容被传递给应用自己解析和后续处理，友盟不对消息内容进行展示和提醒。通知/消息-iOS: 和APNs定义一致。测试模式-Android: 在广播、组播等大规模发送消息的情况下，为了防止开发者误发消息, 增加了测试模式。 测试模式下，只会将消息发送给测试设备。测试设备需要到网站上添加。测试模式对单播不生效。测试模式-iOS: iOS的测试模式对应APNs的开发环境(sandbox)。2 接口描述2.1 消息发送2.1.1 功能说明开发者调用此接口，向 指定终端用户(单播)、 所有终端用户(广播) 或 满足特定条件的终端用户群(组播)，发送 通知 或 消息。此外，该接口还支持开发者使用 自有的账号系统(alias) 来发送消息给指定的账号或者账号群。注意，苹果推送的相关协议，请严格按照APNs的协议来填写，友盟完全遵循APNs的协议。2.1.2 调用地址POST?/api/send?sign=yoursign?签名（sign=yoursign)的计算方式参见附录。2.1.3 调用参数 [Java]?纯文本查看?复制代码 ? 001 002 003 004 005 006 007 008 009 010 011 012 013 014 015 016 017 018 019 020 021 022 023 024 025 026 027 028 029 030 031 032 033 034 035 036 037 038 039 040 041 042 043 044 045 046 047 048 049 050 051 052 053 054 055 056 057 058 059 060 061 062 063 064 065 066 067 068 069 070 071 072 073 074 075 076 077 078 079 080 081 082 083 084 085 086 087 088 089 090 091 092 093 094 095 096 097 098 099 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 { ??appkey:xx,????????? // 必填 应用唯一标识 ??timestamp:xx,?????? // 必填 时间戳，10位或者13位均可。时间戳有效期为10分钟。 ??validation_token:xx,// 必填 验证码，validation_token为appkey, app_master_secret与timestamp的MD5码, ??????????????????????????//????? 示例代码参照附录G。如果使用了签名，则这个字段不填。 ??type:xx,??????????? // 必填 消息发送类型,其值为unicast,broadcast,groupcast,customizedcast或者filecast. ??????????????????????????//????? unicast-单播 ??????????????????????????//????? filecast-文件播(多个device_token可以通过文件形式批