0.4.7 • Published 7 years ago

getui-rest v0.4.7

Weekly downloads
2
License
ISC
Repository
github
Last release
7 years ago

getui-rest-sdk

个推的nodejs sdk实在是太难用了……功能要啥啥没有,于是只好用rest-api重新封一遍

接口参数参考

http://docs.getui.com/server/rest/push/

Classes

Typedefs

Getui ⇐ EventEmitter

个推RestAPI SDK

Kind: global class
Extends: EventEmitter

new Getui(appId, appKey, masterSecret, interval)

初始化个推RestAPI

ParamTypeDefaultDescription
appIdstring
appKeystring
masterSecretstring
intervalstring | boolean"23h"自动token续期,false禁用

getui.waitAuth() ⇒ Promise

等待认证完成

Kind: instance method of Getui

getui.auth() ⇒ Promise.<void>

认证,token有效期24小时

Kind: instance method of Getui
Throws:

  • Error auth failed

Emits: ready

getui.unauth() ⇒ Promise.<void>

关闭鉴权

Kind: instance method of Getui

getui.pushSingle(message, template, cid, apnsInfo, requestId) ⇒ Promise.<object>

单推

Kind: instance method of Getui
Returns: Promise.<object> - 接口返回的json

ParamTypeDescription
messageMessage
templateNotification | null
cidstringcid
apnsInfoAPNsInfoapns的json,ios需要
requestIdstringrequestId

getui.pushSingleAlias(message, template, alias, apnsInfo, requestId) ⇒ Promise.<object>

单推给alias

Kind: instance method of Getui
Returns: Promise.<object> - 接口返回的json

ParamTypeDescription
messageMessage
templateNotification | null
aliasstringalias
apnsInfoAPNsInfoapns的json,ios需要
requestIdstringrequestId

getui.saveListBody(message, template, apnsInfo, taskName) ⇒ Promise

保存消息共同体

Kind: instance method of Getui

ParamTypeDescription
messageMessage
templateNotification | null
apnsInfoAPNsInfoapns的json,ios需要
taskNamestring任务名称

getui.toList(cidList, taskId, needDetail) ⇒ Promise

群推

Kind: instance method of Getui

ParamTypeDescription
cidListarraycidList
taskIdstring保存消息共同体的返回结果
needDetailboolean默认值:false,是否需要返回每个CID的状态

getui.toListAlias(aliasList, taskId, needDetail) ⇒ Promise

群推alias

Kind: instance method of Getui

ParamTypeDescription
aliasListarrayalias
taskIdstring保存消息共同体的返回结果
needDetailboolean默认值:false,是否需要返回每个CID的状态

getui.pushApp(message, template, apnsInfo, condition, requestId) ⇒ Promise

toapp群推

Kind: instance method of Getui

ParamTypeDescription
messageMessage
templateNotification | null
apnsInfoAPNsInfo
conditionCondition筛选目标用户条件
requestIdstring

getui.stopTask(taskId) ⇒ Promise

停止群推任务

Kind: instance method of Getui

ParamType
taskIdstring

getui.pushSingleBatch(msgList) ⇒ Promise

批量单推

Kind: instance method of Getui

ParamType
msgListarray.<object>

getui.bindAlias(aliasList) ⇒ Promise

绑定别名

Kind: instance method of Getui

ParamTypeDescription
aliasListarray.<object>
aliasList[].cidstringcid
aliasList[].aliasstring别名

getui.queryCid(alias) ⇒ Promise

别名查询

Kind: instance method of Getui

ParamType
aliasstring

getui.queryAlias(cid) ⇒ Promise

根据cid查询别名

Kind: instance method of Getui

ParamType
cidstring

getui.unbindAlias(cid, alias) ⇒ Promise

单个cid和别名解绑

Kind: instance method of Getui

ParamType
cidstring
aliasstring

getui.unbindAliasAll(alias) ⇒ Promise

解绑别名所有cid

Kind: instance method of Getui

ParamType
aliasstring

getui.setTags(cid, tagList) ⇒ Promise

设置tag

Kind: instance method of Getui

ParamType
cidstring
tagListarray.<string>

getui.getTags(cid) ⇒ Promise

获取cid的tag

Kind: instance method of Getui

ParamType
cidstring

getui.userBlkListAdd(cid) ⇒ Promise

添加用户黑名单

Kind: instance method of Getui

ParamType
cidstring

getui.userBlkListDelete(cid) ⇒ Promise

删除用户黑名单

Kind: instance method of Getui

ParamType
cidstring

getui.userStatus(cid) ⇒ Promise

查询用户状态

Kind: instance method of Getui

ParamType
cidstring

getui.pushResult(taskIdList) ⇒ Promise

获取推送结果

Kind: instance method of Getui

ParamType
taskIdListarray.<string>

getui.queryAppUser(date) ⇒ Promise

获取单日用户数据

Kind: instance method of Getui

ParamTypeDescription
datestringyyyymmdd 20170823

getui.queryAppPush(date) ⇒ Promise

获取单日推送数据

Kind: instance method of Getui

ParamTypeDescription
datestringyyyymmdd 20170823

getui.setBadge(badge, cids) ⇒ Promise

应用角标设置接口(仅iOS)

Kind: instance method of Getui

ParamType
badgenumber
cidsarray.<string>

getui.getPushResultByGroupName(groupName) ⇒ Promise

根据任务组名获取推送结果

Kind: instance method of Getui

ParamType
groupNamestring

getui.getLast24HoursOnlineUsreStatistics() ⇒ Promise

获取24小时在线用户数

Kind: instance method of Getui

getui.queryUserCount(condition) ⇒ Promise

按条件查询用户数

Kind: instance method of Getui

ParamType
conditionCondition

getui.queryBiTags() ⇒ Promise

获取可用bi标签

Kind: instance method of Getui

getui.getFeedbackUsers(taskId, cids) ⇒ Promise

获取回执的用户列表

Kind: instance method of Getui

ParamType
taskIdstring
cidsstring

"ready"

认证完成,准备就绪

Kind: event emitted by Getui

"refresh-token"

重新获取了token

Kind: event emitted by Getui

Message : object

Kind: global typedef
Properties

NameTypeDescription
is_offlineboolean是否存为离线消息
offline_expire_timenumber离线时间
push_network_typenumber选择推送消息使用网络类型,0:不限制,1:wifi
msgtypestring消息应用类型,可选项:notification、link、notypopload、transmission

Notification : object

Kind: global typedef
Properties

NameTypeDescription
styleobject样式
style.typenumber样式类型,0-原生,1-个推样式,4-纯图,6-展开通知
style.textstringtext
style.titlestringtitle
style.logostringlogo
style.logourlstringlogoUrl
style.is_ring}boolean是否响铃
style.is_vibrate}boolean是否震动
style.is_clearable}boolean是否可清除
duration_beginstring设定展示开始时间,格式为yyyy-MM-dd HH:mm:ss
duration_endstring设定展示结束时间,格式为yyyy-MM-dd HH:mm:ss
transmission_typeboolean是否透传
transmission_contentstring透传内容

Condition : object

Kind: global typedef
Properties

NameTypeDescription
keystring筛选条件类型名称(省市region,手机类型phonetype,用户标签tag)
valuesstring筛选参数
opt_typestring筛选参数的组合,0:取参数并集or,1:交集and,2:相当与not in {参数1,参数2,....}

APNsInfo : object

Kind: global typedef
Properties

NameTypeDescription
apsobjectapple push service
aps.alertobject消息
aps.alert.bodystring通知文本消息
aps.alert.action-loc-keystring(用于多语言支持)指定执行按钮所使用的Localizable.strings
aps.alert.loc-keystring(用于多语言支持)指定Localizable.strings文件中相应的key
aps.alert.loc-argsArray.<string>如果loc-key中使用了占位符,则在loc-args中指定各参数
aps.alert.launch-imagestring指定启动界面图片名
aps.alert.titlestring通知标题
aps.alert.titile-loc-keystring(用于多语言支持)对于标题指定执行按钮所使用的Localizable.strings,仅支持iOS8.2以上版本
aps.alert.title-loc-argsArray.<string>对于标题,如果loc-key中使用的占位符,则在loc-args中指定各参数,仅支持iOS8.2以上版本
aps.alert.subtitlestring通知子标题,仅支持iOS8.2以上版本
aps.alert.subtitle-loc-keystring当前本地化文件中的子标题字符串的关键字,仅支持iOS8.2以上版本
aps.alert.subtitle-loc-argsstring当前本地化子标题内容中需要置换的变量参数 ,仅支持iOS8.2以上版本
aps.autoBadgestring用于计算icon上显示的数字,还可以实现显示数字的自动增减,如“+1”、 “-1”、 “1” 等,计算结果将覆盖badge
aps.soundstring通知铃声文件名,无声设置为“com.gexin.ios.silence”
aps.content-availablenumber推送直接带有透传数据
aps.categorystring在客户端通知栏触发特定的action和button显示
multimediaArray.<object>多媒体
multimedia[].urlstring多媒体资源地址
multimedia[].typenumber资源类型(1.图片,2.音频, 3.视频)
multimedia[].only_wifiboolean是否只在wifi环境下加载,如果设置成true,但未使用wifi时,会展示成普通通知
0.4.7

7 years ago

0.4.6

7 years ago

0.4.4

7 years ago

0.4.3

7 years ago

0.4.2

7 years ago

0.4.1

7 years ago

0.4.0

7 years ago

0.3.1

7 years ago

0.3.0

7 years ago

0.2.0

7 years ago

0.1.0

7 years ago