ดัชนีอ้างอิงเมธอด API
Pushwoosh มีไลบรารีขนาดใหญ่ของเมธอด API กว่า 100 รายการ ซึ่งจัดหมวดหมู่ตามฟังก์ชันต่างๆ เช่น การส่งการแจ้งเตือน การจัดการผู้ใช้ และการติดตามการวิเคราะห์
Messaging API v2
Anchor link toAPI แบบรวมที่มาแทนที่กลุ่ม /create*Message ทั้งหมด (push, email, SMS, Kakao) ดูที่ ภาพรวม และ คู่มือการย้าย
Notify | สร้างและส่งข้อความเดียวผ่านช่องทางใดก็ได้ แทนที่ /createMessage, /createTargetedMessage, /createEmailMessage, /createSMSMessage, /createKakaoMessage |
Cancel | ยกเลิกข้อความที่สร้างไว้ก่อนหน้านี้ก่อนที่จะถูกส่ง ใช้กับ message_code จาก Notify |
Update | แทนที่ข้อความที่ยังคงกำหนดเวลาไว้ด้วยคำจำกัดความใหม่ (แทนที่ทั้งหมด) ใช้กับ message_code จาก Notify |
เกตเวย์ SMTP
Anchor link toส่งอีเมลธุรกรรมผ่าน SMTP มาตรฐานแทนการเรียก API โดยตรง เกตเวย์จะตรวจสอบสิทธิ์ด้วยรหัสแอปพลิเคชันและโทเค็น API ของคุณ จากนั้นส่งต่อแต่ละข้อความไปยัง Notify ดูที่ การอ้างอิงเกตเวย์ SMTP
Messages API
Anchor link tocreateMessage เลิกใช้แล้ว | สร้างการแจ้งเตือนแบบพุชใหม่ ใช้ Notify แทน |
deleteMessage | ลบข้อความ (ที่ส่งแล้วหรือกำหนดเวลาไว้) และลบออกจากประวัติข้อความ |
getMessageDetails | ดึงรายละเอียดของข้อความ |
createTargetedMessage เลิกใช้แล้ว | สร้างการแจ้งเตือนแบบพุชที่กำหนดเป้าหมายใหม่ ใช้ Notify กับชนิด transactional แทน |
getPushHistory เลิกใช้แล้ว | ใช้ /messages:list เพื่อดึงประวัติข้อความพร้อมข้อมูลโดยละเอียด |
cancelMessage | ยกเลิกข้อความที่กำหนดเวลาไว้ โดยยังคงเก็บไว้ในประวัติข้อความ |
Presets API
Anchor link toCreate | สร้างพรีเซ็ตพุชใหม่ |
List | แสดงรายการพรีเซ็ตพุชของแอปพลิเคชัน |
Get | ดึงพรีเซ็ตพุชเดียวตามรหัส |
Update | เขียนทับพรีเซ็ตพุชตามรหัส |
UpdatePartial | อัปเดตเฉพาะฟิลด์ที่ให้มาของพรีเซ็ตพุชตามรหัส |
Clone | ทำซ้ำพรีเซ็ตพุชภายในแอปพลิเคชันเดียวกัน |
Delete | ลบพรีเซ็ตพุชตามรหัส |
Device API
Anchor link toregisterDevice | ลงทะเบียนอุปกรณ์สำหรับแอปพลิเคชัน |
unregisterDevice | ลบโทเค็นพุชของอุปกรณ์ |
deleteDevice | ลบอุปกรณ์และข้อมูลที่เกี่ยวข้องทั้งหมดในแอปพลิเคชันที่ระบุ |
setTags | ตั้งค่าแท็กสำหรับอุปกรณ์ |
getTags | ดึงแท็กพร้อมค่าที่สอดคล้องกันสำหรับอุปกรณ์เฉพาะ |
setBadge | ส่งค่าป้ายสถานะปัจจุบันสำหรับอุปกรณ์ไปยัง Pushwoosh |
applicationOpen | ลงทะเบียนเหตุการณ์การเปิดแอป |
pushStat | ลงทะเบียนเหตุการณ์การเปิดพุช |
messageDeliveryEvent | ลงทะเบียนเหตุการณ์การส่งพุชสำหรับอุปกรณ์ |
Audience API
Anchor link tobulkSetTags | ตั้งค่าแท็กสำหรับอุปกรณ์หลายเครื่อง |
bulkSetTags Status | ส่งคืนสถานะของการดำเนินการ bulkSetTags |
bulkRegisterDevice | ลงทะเบียนอุปกรณ์หลายเครื่องในคำขอเดียว รวมถึงค่าแท็กที่เป็นตัวเลือกสำหรับแต่ละอุปกรณ์ |
bulkRegisterDevice Status | ดึงสถานะและผลลัพธ์ของคำขอลงทะเบียนอุปกรณ์จำนวนมากโดยใช้ ID คำขอ |
bulkUnregisterDevice | ยกเลิกการลงทะเบียนอุปกรณ์หลายเครื่องในคำขอเดียว |
bulkUnregisterDevice Status | ดึงสถานะและผลลัพธ์ของคำขอยกเลิกการลงทะเบียนอุปกรณ์จำนวนมากโดยใช้ ID คำขอ |
Tags API
Anchor link toaddTag | สร้างแท็กในบัญชีของคุณ |
deleteTag | ลบแท็กพร้อมข้อมูลที่เกี่ยวข้องทั้งหมด |
listTags | ดึงรายการแท็กในบัญชี |
Segmentation (Filters) API
Anchor link tocreateFilter | สร้างเซกเมนต์ใหม่ |
listFilters | ส่งคืนรายการเซกเมนต์ที่มีอยู่พร้อมเงื่อนไข |
deleteFilter | ลบเซกเมนต์ที่มีอยู่ |
exportSegment | กำหนดเวลาคำขอเพื่อส่งออกผู้ติดตามที่ตรงกับเงื่อนไขของเซกเมนต์ |
exportSegment Results | ดึงลิงก์ CSV สำหรับผลลัพธ์ exportSegment |
User-centric API
Anchor link toregisterUser | เชื่อมโยง User ID ภายนอกกับอุปกรณ์ที่ระบุ |
deleteUser | ลบผู้ใช้และอุปกรณ์ทั้งหมดที่เชื่อมโยงกับ User ID ที่ระบุ |
postEvent | เรียกเหตุการณ์ภายในแอป |
Events API
Anchor link tocreateEvent | สร้างเหตุการณ์สำหรับแอป |
Applications API
Anchor link tocreateApplication | สร้างแอปพลิเคชันใหม่ในบัญชี |
updateApplication | อัปเดตการตั้งค่าแอปพลิเคชัน |
deleteApplication | ลบแอปออกจากบัญชี |
getApplication | รับรายละเอียดเกี่ยวกับแอป |
getApplications | ดึงรายการแอปพลิเคชันในบัญชี |
getApplicationFile | ดึงไฟล์การกำหนดค่าที่เกี่ยวข้องกับแอป |
setApplicationPlatformStatus | เปลี่ยนสถานะแพลตฟอร์มของแอป |
Campaigns API
Anchor link tocreateCampaign | สร้างแคมเปญพุชใหม่ |
deleteCampaign | ลบแคมเปญเฉพาะ |
getCampaigns | ดึงรายการแคมเปญสำหรับแอป |
App configuration API
Anchor link toconfigureApplication 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
Anchor link tocreateEmailMessage เลิกใช้แล้ว | สร้างข้อความอีเมล ใช้ Notify กับ platforms: ["EMAIL"] และ email_payload แทน |
registerEmail | ลงทะเบียนที่อยู่อีเมลสำหรับแอป |
deleteEmail | ลบที่อยู่อีเมลออกจากฐานข้อมูลของคุณ |
setEmailTags | ตั้งค่าแท็กสำหรับที่อยู่อีเมลที่ระบุ |
registerEmailUser | เชื่อมโยง User ID ภายนอกกับที่อยู่อีเมลที่ระบุ |
Email Templates API
Anchor link toCreate | สร้างเทมเพลตอีเมลใหม่ในแอปพลิเคชัน |
List | แสดงรายการเทมเพลตอีเมลของแอปพลิเคชัน |
Get | ส่งคืนเทมเพลตอีเมลเดียวตามรหัส |
Update | อัปเดตเทมเพลตอีเมลที่มีอยู่ตามรหัส |
Delete | ลบเทมเพลตอีเมลและพรีเซ็ตที่เชื่อมต่ออยู่ตามรหัส |
Clone | โคลนเทมเพลตอีเมลไปยังแอปพลิเคชันปลายทาง |
Test devices API
Anchor link tocreateTestDevice | ลงทะเบียนอุปกรณ์ทดสอบสำหรับแอปพลิเคชัน |
listTestDevices | ดึงอุปกรณ์ทดสอบทั้งหมดที่ลงทะเบียนสำหรับแอปพลิเคชัน |
Message inbox API
Anchor link togetInboxMessages | ดึงรายการข้อความในกล่องข้อความสำหรับ HWID ที่ระบุ |
inboxStatus | อัปเดตสถานะของข้อความในกล่องข้อความที่ระบุ |
Statistics API
Anchor link toสถิติข้อความ
Anchor link tomessages:list | ดึงรายการข้อความที่ส่งแล้ว |
totalsByIntervals | ให้ข้อมูลเมตริกและข้อมูลคอนเวอร์ชันที่รวบรวมตามชั่วโมง |
getDeliveryFunnel | ส่งคืนช่องทางการส่งสำหรับข้อความเดียว พร้อมรายละเอียดว่าผู้ชมหายไปที่ขั้นตอนใด |
getMessageLog | ดึงข้อมูลโดยละเอียดเกี่ยวกับข้อความที่ส่งแล้ว |
linksInteractions | ให้สถิติเกี่ยวกับการคลิกลิงก์ในอีเมล |
linksInteractionsDevices | แสดงรายชื่อผู้ใช้ที่คลิกลิงก์ในอีเมล |
bouncedEmails | ให้ข้อมูลเกี่ยวกับการตีกลับของอีเมล การร้องเรียน และเหตุผลการตีกลับ |
การส่งออกสถิติข้อความแบบอะซิงโครนัส
Anchor link toexportMessagesStatistics/export | จัดคิวการส่งออกประวัติข้อความไปยังไฟล์ CSV โดยไม่มีการจำกัดแถวของ messages:list |
exportMessagesStatistics/status | ส่งคืนความคืบหน้าของงานส่งออก |
exportMessagesStatistics/result | ส่งคืนชื่อไฟล์ที่สร้างขึ้นเมื่องานเสร็จสมบูรณ์ |
exportMessagesStatistics/lastTasks | แสดงรายการงานส่งออกล่าสุดสำหรับแอปพลิเคชัน |
exportMessagesStatistics/delete | ลบงานและไฟล์ก่อนที่ระยะเวลาการเก็บรักษาจะหมดอายุ |
exportMessagesStatistics/download | ดาวน์โหลดไฟล์ CSV ที่สร้างขึ้นตามชื่อ |
สถิติแอปพลิเคชันและผู้ติดตาม
Anchor link togetApplicationSubscribersStats | ดึงสถิติผู้ติดตามของแอป โดยจัดกลุ่มตามประเภทอุปกรณ์ |
getAppStats | ดึงสถิติแอปสำหรับช่วงเวลาที่ระบุ |
getSubscribersStatistics | ดึงสถิติผู้ติดตามสำหรับช่วงเวลาที่ระบุ |
สถิติแคมเปญ
Anchor link togetCampaignStats | ดึงสถิติแคมเปญสำหรับช่วงเวลาที่ระบุ |
สถิติเหตุการณ์และแท็ก
Anchor link togetEventStatistics | ดึงจำนวนครั้งที่เหตุการณ์ถูกทริกเกอร์ในช่วงเวลาที่ระบุ |
getTagStats | ดึงสถิติสำหรับแท็กที่ระบุ |
สถิติในแอป
Anchor link toinapps:totals | ดึงผลรวมของ impression, interaction และ frequency capping สำหรับแคมเปญในแอปหนึ่งรายการขึ้นไปในช่วงเวลาหนึ่ง |
inapps:timeline | ดึงผลรวมของช่วงเวลาและอนุกรมเวลาของเมตริกในแอปสำหรับแคมเปญเดียว |
iOS Live Activities API
Anchor link tostartLiveActivity | สร้าง iOS Live Activity ใหม่ |
updateLiveActivity | อัปเดต iOS Live Activity ที่มีอยู่ |
Apple Wallet PassKit API
Anchor link toApple Wallet PassKit API | การอ้างอิงสำหรับการจัดการบัตร Apple Wallet และการกำหนดค่าที่เกี่ยวข้องใน Pushwoosh |
Google Wallet API
Anchor link toCreate a pass | สร้างบัตรใน Google Wallet และส่งคืนลิงก์บันทึก |
Validate a pass | ตรวจสอบการกำหนดค่าบัตรโดยไม่ต้องสร้าง |
Update a pass | อัปเดตบัตรที่มีอยู่ Google จะส่งการเปลี่ยนแปลงไปยังอุปกรณ์ที่บันทึกไว้ |
Get a save link | ส่งคืนลิงก์บันทึก “Add to Google Wallet” สำหรับบัตรที่มีอยู่ |
Get a pass | ส่งคืนบัตรที่จัดเก็บไว้เพียงใบเดียว |
List passes | ส่งคืนรายการบัตรแบบแบ่งหน้าสำหรับแอปพลิเคชัน |
Set pass state | เปิดใช้งานหรือทำให้บัตรเป็นโมฆะ |
Delete a pass | ทำให้บัตรใน Google เป็นโมฆะและลบบันทึกใน Pushwoosh |
Get configuration | ส่งคืนสถานะการกำหนดค่า Google Wallet สำหรับแอปพลิเคชัน |
Templates | แสดงรายการเทมเพลตบัตรหรือดึงหนึ่งรายการเพื่อเป็นจุดเริ่มต้น |
Customer Journey API
Anchor link toLifecycle | เริ่ม, หยุดชั่วคราว, สิ้นสุด, ร่าง หรือเก็บ journey ตาม UUID ของมัน |
Create and update | สร้างคำจำกัดความ journey ใหม่หรือแทนที่อันที่มีอยู่ |
Start by API | นำผู้ใช้เข้าสู่จุดเริ่มต้น API ของ journey ที่กำลังทำงานอยู่ |
Get Journey stats | รับสถิติสำหรับ journey ที่ระบุตาม ID ของมัน |
Remove users from journeys | ลบผู้ใช้หนึ่งคนขึ้นไปออกจาก journey ที่ใช้งานอยู่ทั้งหมดหรือที่เลือก |
Scheduled requests API
Anchor link togetResults | ดึงผลลัพธ์ของคำขอที่กำหนดเวลาไว้ |
SMS API
Anchor link tocreateSMSMessage เลิกใช้แล้ว | สร้างข้อความ SMS ใหม่ ใช้ Notify กับ platforms: ["SMS"] แทน |
WhatsApp API
Anchor link tocreateWhatsAppMessage เลิกใช้แล้ว | สร้างข้อความ WhatsApp ใหม่ ใช้ Notify กับ platforms: ["WHATS_APP"] แทน |
LINE API
Anchor link tocreateLineMessage เลิกใช้แล้ว | สร้างข้อความ LINE ใหม่ ใช้ Notify กับ platforms: ["LINE"] แทน |
Kakao API
Anchor link tocreateKakaoMessage เลิกใช้แล้ว | ส่งข้อความ Kakao โดยใช้เทมเพลตที่ได้รับอนุมัติ ใช้ Notify กับ platforms: ["KAKAO"] แทน |
Geozones API
Anchor link togetNearestZone | ดึงพารามิเตอร์ของ geozone ที่ใกล้ที่สุดและระยะทางไปยังมัน นอกจากนี้ยังบันทึกตำแหน่งอุปกรณ์สำหรับการแจ้งเตือนแบบ geo push |
addGeoZone | เพิ่ม Geozone ไปยังแอปที่ระบุ |
updateGeoZone | อัปเดตคุณสมบัติของ Geozone เช่น ชื่อ สถานะ เนื้อหา และระยะ |
deleteGeoZone | ลบ Geozones ออกจากแอป |
addGeoZoneCluster | เพิ่ม Geozone Cluster ไปยังแอป |
deleteGeoZoneCluster | ลบ Geozone Cluster ออกจากแอป |
listGeoZones | ดึงรายการ Geozones สำหรับแอป |
listGeoZoneClusters | ดึงรายการ Geozone clusters สำหรับแอป |