我如何使用访问令牌调用应用程序界面?
选项一:在HTTPS上进行调用
所有应用程序界面调用,还必须通过HTTPS。访问令牌必须包含Canvas在任何应用程序界面调用的URL查询参数。例如,端点攫取
课程的用户列表:
- GET /api/v1/courses.json
要检索Bob的列表, 如果Bob 访问令牌是“token_of_magical_power”,那么您将会:
- GET /api/v1/courses.json?access_token=token_of_magical_powers
需要一个使用应用程序界面的详细示例,请在GitHub上查阅应用程序界面的基本文档。
选项二: 使用请求标题进行调用
使用访问令牌调用应用程序界面的另一方法是将其添加到请求标题里。如果使用curl (一个可用于运行应用程序界面请求的命令程序),您可指定像这样的访问令牌。
- curl -H "Authorization: Bearer <token>" 'http://<canvas>/api/v1/accounts/<account_id>/courses.json'
请注意,该access_token 毕竟不是在URL上。
请参阅应用程序界面文档网站上的例子。