EngageLab

API นี้ใช้เพื่อตรวจสอบสถานะ VIP และเวลาหมดอายุ VIP ของแอปพลิเคชันปัจจุบัน รองรับ AppPush และ WebPush

หมายเหตุ: ศูนย์ข้อมูลและประเภทผลิตภัณฑ์ถูกกำหนดจากโดเมนคำขอหรือเส้นทาง URL ไม่จำเป็นต้องส่งเพิ่มในพารามิเตอร์คำขอ

หมายเหตุ: AppKey จะถูกส่งผ่านข้อมูลรับรอง Basic Auth ของ REST API ไม่จำเป็นต้องส่งเพิ่มใน query string หรือ request body

การรับรองความถูกต้อง

ดูรายละเอียดเพิ่มเติมได้ที่ วิธีการรับรองความถูกต้อง ในภาพรวม REST API

GET v4/app/vip/status

              
              GET v4/app/vip/status

โค้ดนี้โชว์เป็นหน้าต่างลอย

ส่วนหัวคำขอ

GET /v4/app/vip/status Authorization: Basic (base64 auth string) Content-Type: application/json

              
              GET /v4/app/vip/status
Authorization: Basic (base64 auth string)
Content-Type: application/json

โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์คำขอ

ไม่มี

การตอบกลับสำเร็จ

HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8

              
              HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

โค้ดนี้โชว์เป็นหน้าต่างลอย

{ "vip_status": 1, "vip_end_time": 1775059200 }

              
              {
    "vip_status": 1,
    "vip_end_time": 1775059200
}

โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์การตอบกลับ

ฟิลด์	ประเภท	คำอธิบาย
`vip_status`	int	สถานะ VIP `0` หมายถึงทดลองใช้ฟรี, `1` หมายถึงแผนชำระเงินที่ใช้งานอยู่, `2` หมายถึงใช้งานได้แต่รอชำระเงิน, `-1` หมายถึงทดลองใช้ฟรีหมดอายุ, `-2` หมายถึงแผนชำระเงินหมดอายุ และ `-3` หมายถึงใช้งานไม่ได้เพราะรอชำระเงิน
`vip_end_time`	int64	เวลาหมดอายุ VIP เป็น Unix timestamp หน่วยวินาที

การตอบกลับล้มเหลว

HTTP/1.1 401 Unauthorized Content-Type: application/json; charset=utf-8

              
              HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8

โค้ดนี้โชว์เป็นหน้าต่างลอย

{ "error": { "code": 21004, "message": "basic auth failed" } }

              
              {
    "error": {
        "code": 21004,
        "message": "basic auth failed"
    }
}

โค้ดนี้โชว์เป็นหน้าต่างลอย

Code	HTTP	คำอธิบาย	Error Message	รายละเอียด
21004	401	การรับรองความถูกต้องล้มเหลว	basic auth failed	AppKey และ MasterSecret ไม่ตรงกัน หรือไม่ได้ส่งข้อมูลรับรอง Basic Auth
21008	400	ข้อผิดพลาดของพารามิเตอร์คำขอ	app_key is not a 24 size string	AppKey ใน Basic Auth ไม่ยาว 24 อักขระ
21030	503	ข้อผิดพลาดภายในระบบ โปรดลองอีกครั้งภายหลัง	Server response time out, please try again later	บริการภายในตอบกลับหมดเวลา
27000	500	ข้อผิดพลาดภายในระบบ	Server inner err	การเรียกบริการภายในล้มเหลวหรือเกิดข้อผิดพลาดที่ไม่คาดคิด
27001	401	ข้อมูลการรับรองความถูกต้องไม่ถูกต้อง	app_key does not exist or basic info is invalid	AppKey ใน Basic Auth มีความยาวถูกต้อง แต่แอปพลิเคชันไม่มีอยู่ หรือข้อมูลรับรองพื้นฐานของแอปพลิเคชันไม่ถูกต้อง