คุณสามารถจัดการโทเค็นการเข้าถึง API ได้จากการตั้งค่าผู้ใช้ของคุณ โทเค็นการเข้าถึงจะให้สิทธิ์ในการเข้าถึงทรัพยากรของ Canvas ผ่านทาง Canvas API
โทเค็น Canvas สอดคล้องกับสิทธิ์การใช้งาน Canvas หากบัญชี Canvas ของคุณถูกลบ หรือหากคุณไม่ได้เป็นผู้ดูแลระบบอีกต่อไป โทเค็นของคุณก็จะถูกยกเลิกด้วยเช่นกัน
ตัวเลือกที่หนึ่ง: โทรออกผ่าน HTTPS
การเรียกใช้ API ทั้งหมดจะต้องทำผ่าน HTTPS เท่านั้น ต้องใส่ access token เป็นพารามิเตอร์ใน URL ของการเรียกใช้ API ไปยัง Canvas ตัวอย่างเช่น endpoint สำหรับดึงรายการวิชาเรียนของผู้ใช้คือ:
เพื่อดึงรายการของบ็อบออกมา และถ้าโทเค็นการเข้าถึงของบ็อบคือ "token_of_magical_power" คุณจะต้องโทรไป
- GET /api/v1/courses.json?access_token=token_of_magical_powers
สำหรับตัวอย่างการใช้งาน API อย่างละเอียด โปรดดู เอกสารพื้นฐาน API บน GitHub
อีกวิธีหนึ่งในการเรียกใช้ API ด้วยโทเค็นการเข้าถึงคือการเพิ่มโทเค็นลงในส่วนหัวของคำขอ หากใช้ curl (โปรแกรมบรรทัดคำสั่งที่ใช้สำหรับเรียกใช้ API) คุณจะระบุโทเค็นการเข้าถึงดังนี้
โปรดสังเกตว่า access_token ไม่ได้อยู่ใน URL เลย
ดูตัวอย่างได้ที่ เว็บไซต์เอกสารประกอบ API