คุณสามารถเชื่อมต่อการใช้งาน OAuth ของ Studio ผ่าน Postman ซึ่งเป็นแอปพลิเคชันที่ช่วยให้การพัฒนา API ง่ายขึ้น ก่อนเริ่มขั้นตอนใดๆ ในบทความนี้ โปรดตรวจสอบให้แน่ใจว่าคุณสามารถเข้าถึง Postman ในเว็บเบราว์เซอร์ หรือได้ ดาวน์โหลดและติดตั้ง Postman แล้ว และคุณมีบัญชี Studio ที่สามารถสร้าง Client ID และ secret ของ OAuth ได้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Studio API โปรดดู เอกสารประกอบ StudioPublic API
หมายเหตุ: การผสานรวมที่ใช้ URI การเปลี่ยนเส้นทาง urn:ietf:wg:oauth:2.0:oob ในขั้นตอน OAuth จะต้องเพิ่ม URI ดังกล่าวลงในรายการ Redirect URIs ในคีย์นักพัฒนาอย่างชัดเจน
เปิดไปรษณีย์
ใน Postman ให้คลิกไอคอน Collections [1]
คลิกไอคอน เครื่องหมายบวก [2] จากนั้นคลิกตัวเลือก คอลเลกชันว่างเปล่า [3]
สร้างคอลเลกชัน
ตั้งชื่อให้กับคอลเลกชัน
เปิดแท็บการอนุญาต
ในคอลเลกชัน ให้คลิกแท็บ การอนุญาต [1]
คลิกเมนูดรอปดาวน์ ประเภทการตรวจสอบสิทธิ์ [2] และเลือกตัวเลือก OAuth 2.0 [3]
เลื่อนลงมาที่ส่วน "กำหนดค่าโทเค็นใหม่" แล้วป้อนชื่อสำหรับโทเค็น
หมายเหตุ: หากคุณใช้แอป Postman บนเดสก์ท็อป คุณอาจต้องคลิกช่องทำเครื่องหมาย "อนุญาตโดยใช้เบราว์เซอร์"
เปิดผืนผ้าใบ
ในการค้นหา URL การตรวจสอบสิทธิ์และ URL โทเค็นการเข้าถึง ให้เปิด Canvas ในหน้าต่างเบราว์เซอร์ใหม่ ใน Canvas ให้คลิกที่ลิงก์ ผู้ดูแลระบบ [1] จากนั้นคลิกชื่อบัญชีของคุณ [2]
เปิดแท็บแอป
ในการนำทางบัญชี ให้คลิกลิงก์ การตั้งค่า [1] จากนั้นคลิกแท็บ แอป [2]
คลิกปุ่ม View App Configurations [3]
ค้นหาแอปสตูดิโอ
ในรายการแอปภายนอก ให้ค้นหา Studio จากนั้นคลิกปุ่ม การตั้งค่า [1] และเลือกตัวเลือก แก้ไข [2]
ดูรายละเอียดการกำหนดค่าแอป
ในหน้าต่างแก้ไขแอป ให้คัดลอก URL สำหรับการเปิดใช้งาน โดยคัดลอกเฉพาะส่วนที่อยู่หลังชื่อโฮสต์ (ไม่รวมเครื่องหมายทับตัวแรก)
เพิ่ม URL ใน Postman
ใน Postman ให้วาง URL สำหรับการเปิดใช้งาน Studio ลงในช่อง Auth URL และช่อง Access Token URL ทั้งสองช่อง
เพิ่ม /api/public/oauth/authorize ต่อท้าย URL ของช่อง Auth [1]
เพื่อสิ้นสุดฟิลด์ URL ของโทเค็นการเข้าถึง [2] ให้เพิ่ม /api/public/oauth/token ต่อท้าย URL
คัดลอก URL การเรียกกลับ
ในการสร้างคีย์สำหรับนักพัฒนาใน Studio คุณจะต้องใช้ URL การเรียกกลับ (Callback URL) จาก Postman คัดลอก URL การเรียกกลับนี้
สตูดิโอเปิด
เปิดโปรแกรม Studio ไม่ว่าจะผ่านทางอินสแตนซ์ Studio แบบสแตนด์อโลน หรือผ่านทาง Canvas ก็ได้
ใน Studio ให้คลิกลิงก์ การตั้งค่า [1] จากนั้นคลิกแท็บ Developer Keys [2] หากต้องการเพิ่มคีย์นักพัฒนาใหม่ ให้คลิกปุ่ม Add Developer Key [3]
สร้างคีย์นักพัฒนา Studio
ในหน้าต่างการตั้งค่าคีย์ ให้ป้อนชื่อสำหรับคีย์ในช่อง ชื่อ [1]
ในช่อง Redirect URIs [2] ให้วาง URL Callback ที่คุณคัดลอกมาจาก Postman
เมื่อคุณสรุปรายละเอียดคีย์เสร็จแล้ว ให้คลิกปุ่ม บันทึกคีย์ [3]
หมายเหตุ: การผสานรวมที่ใช้ URI การเปลี่ยนเส้นทาง urn:ietf:wg:oauth:2.0:oob ในขั้นตอน OAuth จะต้องเพิ่ม URI ดังกล่าวลงในรายการ Redirect URIs ในคีย์นักพัฒนาอย่างชัดเจน
คัดลอกรหัสลูกค้าและรหัสลับ
คีย์นักพัฒนาใหม่จะแสดงใน Studio คัดลอก Client ID [1] หากต้องการแสดงรหัสลับ ให้คลิกปุ่ม Show [2] แล้วคัดลอก รหัสลับ [2]
รับโทเค็นการเข้าถึงใหม่
ใน Postman ให้วาง Client ID และ Client Secret จาก Studio ลงในช่องที่เกี่ยวข้อง [1] ช่องที่เหลือเป็นตัวเลือก
เมื่อคุณป้อนรายละเอียดโทเค็นทั้งหมดแล้ว ให้คลิกปุ่ม รับโทเค็นการเข้าถึงใหม่ [2]
เข้าสู่ระบบสตูดิโอ
หน้าต่างป๊อปอัพหรือแท็บใหม่จะแจ้งให้คุณเข้าสู่ระบบ Studio คุณสามารถเข้าสู่ระบบโดยใช้ข้อมูลประจำตัวบัญชี Studio แบบสแตนด์อโลน [1] หรือใช้ข้อมูลประจำตัว Canvas ของคุณ [2]
อนุญาตให้บุรุษไปรษณีย์
โปรแกรม Studio จะแจ้งให้คุณอนุญาตการเข้าถึง Postman ในหน้าต่าง Studio ให้คลิกปุ่ม Authorize
ดูระยะเวลาหมดอายุของโทเค็น
หลังจากที่คุณยืนยันการอนุญาตสำหรับโทเค็นแล้ว Postman จะแสดงรายละเอียดของโทเค็น โทเค็นมีจำนวนจำกัด ในส่วน "โทเค็นปัจจุบัน" โทเค็นจะแสดงเวลาและวันที่หมดอายุ