跳到内容

API 方法参考索引

Pushwoosh 提供了包含 100 多种 API 方法的庞大库,这些方法按发送通知、管理用户和跟踪分析等不同功能进行了分类。

消息 API

Anchor link to
createMessage创建一个新的推送通知。
deleteMessage删除一个已计划的消息。
getMessageDetails检索消息详情。
createTargetedMessage创建一个新的定向推送通知,用于跨多个应用的高级定向。
getPushHistory获取包含推送详情的消息历史记录。
cancelMessage取消一个已计划的消息。

预设 API

Anchor link to
createPreset创建一个新的预设。
getPreset检索指定推送预设的参数。
listPresets检索为应用创建的预设列表。
deletePreset从您的账户中删除一个预设。

设备 API

Anchor link to
registerDevice为应用程序注册一个设备。
unregisterDevice移除设备的推送令牌。
setTags为设备设置标签值。
getTags检索特定设备的标签及其对应值。
setBadge将设备的当前角标值发送到 Pushwoosh。
applicationOpen注册一个应用打开事件。
pushStat注册一个推送打开事件。
messageDeliveryEvent为设备注册一个推送送达事件。

受众 API

Anchor link to
bulkSetTags为多个设备设置标签值。
bulkSetTags Status返回 bulkSetTags 操作的状态。
bulkRegisterDevice在单个请求中注册多个设备,可为每个设备包含可选的标签值。
bulkRegisterDevice Status使用请求 ID 检索批量设备注册请求的状态和结果。
bulkUnregisterDevice在单个请求中注销多个设备。
bulkUnregisterDevice Status使用请求 ID 检索批量设备注销请求的状态和结果。

标签 API

Anchor link to
addTag在您的账户中创建一个标签。
deleteTag移除一个标签及其所有相关信息。
listTags检索账户上的标签列表。

细分 (筛选器) API

Anchor link to
createFilter创建一个新的细分。
listFilters返回可用细分及其条件的列表。
deleteFilter删除一个现有的细分。
exportSegment安排一个请求,以导出匹配细分条件的订阅者。
exportSegment Results检索 exportSegment 结果的 CSV 链接。

以用户为中心的 API

Anchor link to
registerUser将外部 User ID 与指定设备关联。
postEvent在应用内调用事件。

事件 API

Anchor link to
createEvent为应用创建一个事件。

应用程序 API

Anchor link to
createApplication在账户上创建一个新应用程序。
updateApplication更新应用程序设置。
deleteApplication从账户中删除应用。
getApplication获取有关应用的详细信息。
getApplications检索账户上的应用程序列表。
getApplicationFile检索与应用相关的配置文件。
setApplicationPlatformStatus更改应用平台的状态。

营销活动 API

Anchor link to
createCampaign创建一个新的推送营销活动。
deleteCampaign删除一个特定的营销活动。
getCampaigns检索应用的营销活动列表。

应用配置 API

Anchor link to
configureApplication for iOS为应用配置 iOS 平台。
configureApplication for Android为应用配置 Android 平台。
configureApplication for Mac OS X为应用配置 macOS 平台。
configureApplication for Windows为应用配置 Windows 平台。
configureApplication for Amazon为应用配置 Amazon 平台。
configureApplication for Chrome为应用配置 Chrome 平台。
configureApplication for Safari为应用配置 Safari 平台。
configureApplication for Firefox为应用配置 Firefox 平台。
configureApplication for Email为应用配置 Email 平台。

电子邮件 API

Anchor link to
createEmailMessage创建一封电子邮件消息。
registerEmail为应用注册一个电子邮件地址。
deleteEmail从您的数据库中移除一个电子邮件地址。
setEmailTags为指定的电子邮件地址设置标签值。
registerEmailUser将外部 User ID 与指定的电子邮件地址关联。

测试设备 API

Anchor link to
createTestDevice为应用程序注册一个测试设备。
listTestDevices检索为应用程序注册的所有测试设备。

消息收件箱 API

Anchor link to
getInboxMessages检索指定 HWID 的收件箱消息列表。
inboxStatus更新特定收件箱消息的状态。

统计 API

Anchor link to

消息统计

Anchor link to
messages:list检索已发送消息的列表。
totalsByIntervals提供按小时汇总的指标和转化数据。
getMessageLog检索有关已发送消息的详细信息。
linksInteractions提供有关电子邮件链接点击的统计信息。
linksInteractionsDevices列出点击了电子邮件中链接的用户。
bouncedEmails提供有关电子邮件退回、投诉和退回原因的信息。

应用程序和订阅者统计

Anchor link to
getApplicationSubscribersStats检索应用的订阅者统计信息,按设备类型分组。
getAppStats检索特定时间段的应用统计信息。
getSubscribersStatistics检索特定时间段的订阅者统计信息。

营销活动统计

Anchor link to
getCampaignStats检索特定时间段的营销活动统计信息。

事件和标签统计

Anchor link to
getEventStatistics检索在特定时期内事件被触发的次数。
getTagStats检索特定标签的统计信息。

iOS Live Activities API

Anchor link to
startLiveActivity创建一个新的 iOS Live Activity。
updateLiveActivity更新一个现有的 iOS Live Activity。

Customer Journey API

Anchor link to
Get Journey stats通过其 ID 获取特定 Journey 的统计数据。
Remove users from journeys从所有或选定的活动 Journey 中移除一个或多个用户。

已计划请求 API

Anchor link to
getResults检索已计划请求的结果。
createSMSMessage创建一条新的 SMS 消息。

WhatsApp API

Anchor link to
createWhatsAppMessage创建一条新的 WhatsApp 消息。
createLineMessage创建一条新的 LINE 消息。

地理区域 API

Anchor link to
getNearestZone检索最近的地理区域参数及其距离。同时记录设备位置以用于地理推送通知。
addGeoZone向特定应用添加一个地理区域。
updateGeoZone更新地理区域属性,如名称、状态、内容和范围。
deleteGeoZone从应用中移除地理区域。
addGeoZoneCluster向应用添加一个地理区域集群。
deleteGeoZoneCluster从应用中移除一个地理区域集群。
listGeoZones检索应用的地理区域列表。
listGeoZoneClusters检索应用的地理区域集群列表。