ข้ามไปยังเนื้อหา

API ที่เน้นผู้ใช้เป็นศูนย์กลาง

registerUser

Anchor link to

POST https://api.pushwoosh.com/json/1.3/registerUser

เชื่อมโยง User ID ภายนอกกับอุปกรณ์ที่ระบุ

Request headers

Anchor link to
ชื่อจำเป็นค่าคำอธิบาย
Authorizationจำเป็นToken XXXXAPI Device Token สำหรับเข้าถึง Device API แทนที่ XXXX ด้วย Device API token ที่แท้จริงของคุณ

Request body

Anchor link to
ชื่อประเภทคำอธิบาย
userIdstringUser ID ที่จะเชื่อมโยงกับอุปกรณ์ หากว่างเปล่า ให้ใช้ hwid
application*stringรหัสแอปพลิเคชัน Pushwoosh
hwid*stringPushwoosh HWID
tz_offsetintegerออฟเซ็ตไทม์โซนเป็นวินาทีสำหรับอุปกรณ์
device_typeintegerประเภทอุปกรณ์ ดูค่าที่เป็นไปได้ใน /registerDevice
{
"status_code": 200,
"status_message": "OK",
"response": null
}

สามารถใช้ในภายหลังในการเรียก API /createMessage (พารามิเตอร์ users)
เป็นเรื่องปกติที่จะเรียกใช้ฟังก์ชันนี้ก่อนที่คุณจะมี push token และก่อนการเรียก /registerDevice

Example
{
"request": {
"userId": "user_3078a", // ไม่บังคับ หากว่างเปล่า ให้ใช้ hwid
"application": "XXXXX-XXXXX", // บังคับ รหัสแอปพลิเคชัน Pushwoosh
"hwid": "8f65b16df378e7a6bece9614e1530fb2", // บังคับ รหัสอุปกรณ์ฮาร์ดแวร์
"tz_offset": -3600, // ไม่บังคับ ออฟเซ็ตไทม์โซนเป็นวินาที
"device_type": 3 // ไม่บังคับ ประเภทอุปกรณ์ ดูใน /registerDevice
// สำหรับประเภทอุปกรณ์
}
}

POST https://api.pushwoosh.com/json/1.3/postEvent

เรียกใช้อีเวนต์

Request headers

Anchor link to
ชื่อจำเป็นค่าคำอธิบาย
Authorizationจำเป็นToken XXXXAPI Device Token สำหรับเข้าถึง Device API แทนที่ XXXX ด้วย Device API token ที่แท้จริงของคุณ

Request body

Anchor link to
ชื่อประเภทคำอธิบาย
hwid*stringรหัสอุปกรณ์ฮาร์ดแวร์ ที่ใช้ในคำขอ /registerDevice สามารถใช้ร่วมกับ ‘userId’ เพื่อระบุผู้ใช้ที่ทริกเกอร์อีเวนต์
application*stringรหัสแอปพลิเคชัน Pushwoosh
event*stringชื่ออีเวนต์ตรงตามที่สร้างใน Pushwoosh Control Panel
attributes*objectอ็อบเจกต์ JSON พร้อมแอตทริบิวต์ของอีเวนต์ ปล่อยให้ว่างไว้หากไม่จำเป็นต้องส่งแอตทริบิวต์ใดๆ
timestampUTCintegerการประทับเวลาในรูปแบบ UTC
timestampCurrentintegerการประทับเวลาในเวลาท้องถิ่น
userId*stringUser ID ที่เชื่อมโยงกับผู้ใช้ที่ทริกเกอร์อีเวนต์ สามารถแทนที่หรือใช้ร่วมกับ HWID ได้
device_typeintegerดูค่าที่เป็นไปได้ในเมธอด /registerDevice
{
"status_code": 200,
"status_message": "OK",
"response": {
"code": "61BC9-84DD0"
}
}

ชื่ออีเวนต์ในคำขอต้องตรงกับชื่ออีเวนต์ใน Pushwoosh Control Panel โปรดทราบว่าคุณสมบัติ “attributes” อาจว่างเปล่าได้ (แต่ห้ามละเว้น) ในกรณีที่อีเวนต์ไม่มีแอตทริบิวต์

Example
{
"request":{
"hwid": "8f65b16df378e7a6bece9614e1530fb2", // บังคับ รหัสอุปกรณ์ฮาร์ดแวร์ที่ใช้ใน /registerDevice API
// สามารถใช้ร่วมกับ userId เพื่อระบุ
// ผู้ใช้ที่ทริกเกอร์อีเวนต์
"application": "XXXXX-XXXXX", // บังคับ รหัสแอปพลิเคชัน Pushwoosh
"event": "activityCompleted", // บังคับ ชื่ออีเวนต์ตรงตามที่สร้างใน Pushwoosh Control Panel
"attributes": { // บังคับ ปล่อยให้ว่างไว้หากไม่จำเป็นต้องส่งแอตทริบิวต์ใดๆ
"login": "facebook",
"success": "yes",
"internet": "wifi",
},
"timestampUTC": 1435228403, // ไม่บังคับ การประทับเวลาในรูปแบบ UTC
"timestampCurrent": 1435253603, // ไม่บังคับ การประทับเวลาในเวลาท้องถิ่น
"userId": "someuser@user.com", // บังคับ User ID ที่ใช้สำหรับการระบุตัวตน
// ผู้ใช้บนอุปกรณ์หลายเครื่อง สามารถแทนที่
// หรือใช้ร่วมกับ HWID
"device_type": 1 // ไม่บังคับ
}
}