导航|地址|刷新
开发前必读-个推文档中心







文档中心开发者中心

，欢迎您！

您的优惠服务将于到期。





基本资料



安全设置



应用管理




退出登录
登录/注册SDK下载个推学堂请选择产品
消息推送

用户运营

OneID服务

AI应用工坊

统计分析

用户分析

标签管理

模型管理

短信服务

数字人外呼

一键认证

合规检测

点击提升







体验更多产品服务


欢迎登录开发者中心

立即登录

本月不再提醒





快速入门
快速接入指南

产品简介

开发者中心使用说明

进阶功能

名词解释

多厂商推送接入说明


客户端
Android
概述

3分钟演示

集成指南

API接口

进阶功能

AppLink集成

Maven集成视频


Android多厂商
厂商应用开通指南

厂商SDK集成指南

厂商消息报表补全

厂商SDK更新日志

厂商通道限额&QPS说明


iOS
概述

3分钟演示

集成指南

API接口

AppLink集成

iOS 证书配置指南

iOS集成视频

隐私清单说明


HarmonyOS
概述

集成指南

厂商应用开通指南

API接口


小程序

客户端插件

卓信ID
概述

使用指南

Android接口

iOS接口

服务端接口


Open Harmony
简介

使用入门

通知类型介绍

获取Push Token

推送场景化消息
发送通知消息

发送语音播报消息

推送后台消息


Push Kit常见问题



服务端
RestAPI V2 (推荐使用)
开发前必读

接口调用规范

进阶功能说明

公共参数

多厂商参数

鉴权API

推送API

统计API

用户API

返回码说明

服务端 SDK


老版文档
导航


个推回执文档

Open Harmony API
场景化消息
功能介绍

请求体结构说明

请求体参数说明

响应参数

请求示例


基于应用信息生成鉴权令牌



推送应用场景
三方账号打通

自定义通知铃声

消息分类

自定义通知图标

角标设置

通知大图、大文本

标签推送

emoji 表情推送

消息终止、覆盖和撤回

微信小程序推送

iOS 时效性通知（即时通知）

LiveActivity(灵动岛）文档说明


点击提升方案
文案圈人操作手册

流程画布操作手册

应用内弹窗操作手册

点击提升方案集成指南

到达率提升方案

点击率提升方案


常见问题
客户端推送常见问题

Android常见问题

iOS常见问题

服务端常见问题


SDK更新日志

购买指南
消息推送计费说明

消息推送购买指引


推送服务使用协议




当前位置：个推文档 > 服务端 > RestAPI V2 (推荐使用) > 开发前必读



开发前必读


开发前必读

接入步骤

第一步: 创建应用并获取应用信息

可参考开发者中心使用说明

第二步: 使用应用秘钥信息获取公共参数 token

可参考获取鉴权token 接口

第三步: 使用rest api发送消息

可参考详细文档 了解如何推送

接口文档格式说明
接口地址: /xxx 请求方式: GET/POST/PUT/DELETE request请求说明 路径参数 ...header参数 ... body参数 ... response响应说明 成功响应数据格式 content-type: ... http code: ... 返回值示例 ... 返回结构说明 ... 返回参数data说明 ... 请求示例 ...
路径参数: 路径中以$符号开头的参数，如果含有中文需要编码(UrlEncode)后传输

V2的优点

严格按照RestFul风格设计接口，包括url路径的调整，method的区别使用等

入参更合理，减少了结构嵌套，分类更清晰，默认值更合理，开发者使用更聚焦

出参结构更统一，方便开发者做解析

接入更简便，文档结构进行了重新整理

欢迎开发者提出优化意见：support@getui.com

推送流程



相比V1

名词变更解释

名词	V1	V2
接口调用凭据	authtoken	token
推送目标用户	condition	audience.tag，详见参数说明
消息过期时间	通过is_offline和offline_expire_time两个参数控制	ttl
定时任务推送时间	pushTime，格式：yyyyMMddHHmm	schedule_time ，格式：毫秒时间戳(实际推送时间精确到分钟)
任务组名	task_name	group_name
个推消息类型	msg_type	push_message，详见参数说明
厂商消息内容	push_info表示ios消息内容，notify表示android消息内容	push_channel，详见参数说明

V1地址入口

快速入门

常用说明

消息推送方式

其它接口

推送模板




以上文档对您是否有帮助？
有帮助没帮助



您的改进建议

是否遇到以下问题

问题类型


1、内容与功能不一致；

2、文章描述不清晰；

3、图片和视频难理解；

4、对产品功能不满意；

5、不是我想要的内容；

6、其他:


问题类型不能为空



反馈建议



联系方式



取 消提 交





反馈成功

非常感谢您的反馈，我们会继续努力做到更好！
确定






在这篇文章中：接入步骤接口文档格式说明V2的优点推送流程相比V1V1地址入口





开发者中心SDK 下载



文档中心搜索

搜 索















------
导航页 打开网址