โทเค็นการเข้าถึง API

API Access Token คือตัวระบุที่ไม่ซ้ำกันซึ่งกำหนดให้กับโปรเจกต์ใดโปรเจกต์หนึ่งหรือหลายโปรเจกต์ในบัญชีของคุณ ใช้สำหรับยืนยันตัวตนบัญชีของคุณเพื่อจัดการโปรเจกต์ผ่าน API ซึ่งรวมถึงการแก้ไขบัญชี การส่งข้อความ การแก้ไขโปรเจกต์ และอื่นๆ

Pushwoosh มี API Access Token สองประเภทที่แตกต่างกัน: Server และ Device

โทเค็นแต่ละประเภทจะใช้ได้เฉพาะกับขอบเขต API ของตัวเองเท่านั้น หากใช้โทเค็นที่ไม่ถูกต้อง จะเกิดข้อผิดพลาดในการยืนยันตัวตน

Server API token ใช้กับเมธอด API ทั้งหมด ยกเว้นเมธอดที่อยู่ภายใต้ Device API โทเค็นนี้ควรจะถูกรวมอยู่ในส่วน body ของ request ในฟิลด์ auth

Device API token ใช้สำหรับเมธอดของ Device API เท่านั้น โทเค็นนี้ควรจะถูกรวมอยู่ในเฮดเดอร์ของ HTTP request โดยใช้เฮดเดอร์ Authorization ด้านล่างนี้คือตัวอย่างรูปแบบเฮดเดอร์ที่ถูกต้อง:

Authorization: Token <device_api_token>

แทนที่ <device_api_token> ด้วยค่า Device API Token ของคุณ

คุณสามารถดู สร้าง และจัดการ API Access token ของคุณได้ในส่วน API Access ของ Pushwoosh Control Panel หากต้องการเข้าถึง ให้ไปที่ Settings → API Access

โดยค่าเริ่มต้น แต่ละบัญชีจะมีโทเค็นที่ชื่อว่า Pushwoosh Demo App ซึ่งถูกตั้งค่าเป็น server token

หากต้องการสร้าง API Access token ใหม่:

1. ไปที่ส่วน API Access ใน Control Panel

2. คลิก Generate New Token

3. ในหน้าต่างที่ปรากฏขึ้น ให้เลือกประเภทของโทเค็น:

   • Server ใช้สำหรับเมธอด API ส่วนใหญ่ (ยกเว้นเมธอด Device API)

   • Device ใช้สำหรับเมธอด Device API เท่านั้น

4. ป้อนชื่อสำหรับโทเค็น

5. คลิก Generate เพื่อสร้างโทเค็น

สำคัญ: ตรวจสอบให้แน่ใจว่าได้ให้สิทธิ์การเข้าถึงแอปที่ถูกต้องใน Pushwoosh Control Panel แก่โทเค็น เรียนรู้เพิ่มเติม

โทเค็นใหม่จะปรากฏในรายการ API Access จากตรงนั้น คุณสามารถคัดลอกค่าเพื่อใช้ในคำขอ API หรือจัดการสิทธิ์การเข้าถึงได้ตามต้องการ

หากต้องการจัดการ API token ที่มีอยู่ ให้คลิกที่ เมนูสามจุด (⋮) ถัดจากรายการโทเค็นในส่วน API Access

มีตัวเลือกดังต่อไปนี้:

ให้สิทธิ์โทเค็นในการเข้าถึงทุกโปรเจกต์ในบัญชีของคุณ ซึ่งจะทำให้สามารถใช้ API ได้อย่างเต็มที่ในทุกโปรเจกต์

ลบสิทธิ์การเข้าถึงทุกโปรเจกต์ในบัญชีของคุณของโทเค็น โทเค็นจะไม่สามารถใช้ API ได้อีกจนกว่าจะมีการให้สิทธิ์อีกครั้ง

เปิดหน้าจอ Edit API Token Permissions ซึ่งคุณสามารถ:

• เปลี่ยนชื่อโทเค็น

• คัดลอกค่าโทเค็น

• เลือกโปรเจกต์ที่โทเค็นสามารถเข้าถึงได้โดยการเลือกหรือยกเลิกการเลือกในรายการ

หลังจากทำการเปลี่ยนแปลงเสร็จสิ้น ให้คลิก Save เพื่อใช้การเปลี่ยนแปลง

ลบโทเค็นออกจากบัญชีของคุณอย่างถาวร

ในการให้สิทธิ์คำขอ API ให้ใช้ API Access token ประเภทที่ถูกต้องตามประเภทของเมธอด API ที่คุณเรียกใช้:

รวมโทเค็นไว้ในฟิลด์ “auth” ของ body ของ request: ตัวอย่าง:

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "yxoPUlwqm…………pIyEX4H", // วาง server token ของคุณที่นี่
    "notifications": [{
      "send_date": "now",
      "content": "Hello world"
    }]
  }
}

ใช้ Device token โดยรวมไว้ในเฮดเดอร์ของ HTTP request โดยใช้รูปแบบต่อไปนี้:

Authorization: Token <device_api_token>

แทนที่ <device_api_token> ด้วยค่าโทเค็นจริงของคุณ