API 方法参考索引

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

Messaging API v2

统一的 API，取代了整个 /create*Message 系列（推送、电子邮件、短信、Kakao）。请参阅概述和迁移指南。

Notify	通过任何渠道创建并发送单条消息。取代 /createMessage、/createTargetedMessage、/createEmailMessage、/createSMSMessage、/createKakaoMessage。
Cancel	在消息送达前取消先前创建的消息。与来自 Notify 的 message_code 一起使用。

SMTP 网关

通过标准 SMTP 提交事务性电子邮件，而不是直接调用 API。网关使用您的应用程序代码和 API 令牌进行身份验证，然后将每条消息转发到 Notify。请参阅 SMTP 网关参考。

Messages API

createMessage 已弃用	创建新的推送通知。请改用 Notify。
deleteMessage	删除已计划的消息。
getMessageDetails	检索消息详情。
createTargetedMessage 已弃用	创建新的定向推送通知。请改用具有 transactional 类型的 Notify。
getPushHistory 已弃用	使用 /messages:list 检索包含详细数据的消息历史记录。
cancelMessage	取消已计划的消息。

Presets API

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

Device API

registerDevice	为应用程序注册设备。
unregisterDevice	移除设备的推送令牌。
deleteDevice	删除指定应用程序中的设备及其所有关联数据。
setTags	为设备设置标签值。
getTags	检索特定设备的标签及其对应值。
setBadge	将设备的当前角标值发送到 Pushwoosh。
applicationOpen	注册应用打开事件。
pushStat	注册推送打开事件。
messageDeliveryEvent	为设备注册推送送达事件。

Audience API

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

Tags API

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

Segmentation (Filters) API

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

User-centric API

registerUser	将外部 User ID 与指定设备关联。
deleteUser	删除用户以及与指定 User ID 关联的所有设备。
postEvent	在应用内调用事件。

Events API

createEvent	为应用创建事件。

Applications API

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

Campaigns API

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

App configuration API

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 平台。

Email API

createEmailMessage 已弃用	创建电子邮件消息。请改用带有 platforms: ["EMAIL"] 和 email_payload 的 Notify。
registerEmail	为应用注册电子邮件地址。
deleteEmail	从您的数据库中移除电子邮件地址。
setEmailTags	为指定的电子邮件地址设置标签值。
registerEmailUser	将外部 User ID 与指定的电子邮件地址关联。

Test devices API

createTestDevice	为应用程序注册测试设备。
listTestDevices	检索为应用程序注册的所有测试设备。

Message inbox API

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

Statistics API

消息统计

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

应用程序和订阅者统计

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

营销活动统计

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

事件和标签统计

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

iOS Live Activities API

startLiveActivity	创建新的 iOS Live Activity。
updateLiveActivity	更新现有的 iOS Live Activity。

Apple Wallet PassKit API

Apple Wallet PassKit API	在 Pushwoosh 中管理 Apple Wallet 通行证及相关配置的参考。

Google Wallet API

Create a pass	在 Google Wallet 中创建通行证并返回保存链接。
Validate a pass	检查通行证配置而不创建它。
Update a pass	更新现有通行证。Google 会将更改发送到已保存的设备。
Get a save link	为现有通行证返回“添加到 Google Wallet”的保存链接。
Get a pass	返回单个存储的通行证。
List passes	返回应用程序的通行证分页列表。
Set pass state	激活或作废通行证。
Delete a pass	在 Google 中作废通行证并移除其 Pushwoosh 记录。
Get configuration	返回应用程序的 Google Wallet 配置状态。
Templates	列出通行证模板或获取一个作为起点。

Customer Journey API

Lifecycle	通过其 UUID 启动、暂停、完成、草稿或归档一个 Journey。
Create and update	创建新的 Journey 定义或替换现有的定义。
Start by API	将用户注入正在运行的 Journey 的 API 入口点。
Get Journey stats	通过其 ID 获取特定 Journey 的统计数据。
Remove users from journeys	从所有或选定的活动 Journey 中移除一个或多个用户。

Scheduled requests API

getResults	检索已计划请求的结果。

SMS API

createSMSMessage 已弃用	创建新的 SMS 消息。请改用带有 platforms: ["SMS"] 的 Notify。

WhatsApp API

createWhatsAppMessage 已弃用	创建新的 WhatsApp 消息。请改用带有 platforms: ["WHATS_APP"] 的 Notify。

LINE API

createLineMessage 已弃用	创建新的 LINE 消息。请改用带有 platforms: ["LINE"] 的 Notify。

Kakao API

createKakaoMessage 已弃用	使用批准的模板发送 Kakao 消息。请改用带有 platforms: ["KAKAO"] 的 Notify。

Geozones API

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