Java开发工具包
使用说明
概述
轻推JAVA-SDK是轻推开放平台面向Java开发者提供的发工具包。通过使用轻推JAVA-SDK,Java开发者可借助轻推高效地使用消息推送,安全登录等功能。
此文档面向Java开发者介绍轻推JAVA-SDK如何使用及相关注意事项。
使用步骤
步骤一:获取AppID以及AppSecret
登录轻推企业管理系统,编辑轻应用/订阅号,获取AppID以及AppSecret,若需要使用轻推安全登录则需要填写安全域名。
步骤二:引入lib文件
引入轻推JAVA-SDK lib包
步骤三:填写配置文件
classpath根目录下新建qingtui.properties文件,APP_ID,APP_SECRET,baseURL(https://open.qingtui.com/v1
)及teamURL(https://open.qingtui.com/team
)
步骤四:接口调用
部分服务类接口介绍:
单个消息接口:SingleMessageService
开发者可以通过此接口向单个用户推送消息,支持文本、图片、文本卡片、key-value、文件、图文、待办等所有类型消息。
服务消息接口:ServiceMessageService
开发者可以通过此接口向所有关注了此轻应用/订阅号的用户推送消息,支持文本、图片、文本卡片、key-value、文件、图文等类型消息。
群发消息接口:MassMessageService
开发者可以通过此接口向多个用户推送消息,支持文本、图片、文本卡片、key-value、文件、图文、待办等所有类型消息。
多媒体接口:MediaService
开发者可以通过此接口向服务器上传多媒体文件。
授权项操作接口:TokenService
此接口用于获取和更新token,用于调用其他接口
备注:token有效期为两小时,因此每两小时需要刷新一次token,尽量不要每次发送消息之前都去刷新token,建议使用token中控服务来刷新token,全局接口调用使用同一个token。
安全登录接口:OAuthService
获取授权用户的基本信息
企业接口:DomainService
可根据企业号获取企业id。使用此接口需要企业管理员对轻应用授予通讯录权限
成员接口:MemberService
可获取企业成员信息,创建企业内成员,更新成员信息。使用此接口需要企业管理员对轻应用授予通讯录权限
组织机构接口:OrgService
可获取企业的组织机构信息,创建组织机构,更新组织机构。使用此接口需要企业管理员对轻应用授予通讯录权限
资源下载
JAVA-SDK 点击下载