Sie können API-Zugriffstoken in Ihren Benutzereinstellungen verwalten. Zugriffstoken ermöglichen den Zugriff auf Canvas-Ressourcen über die Canvas-API.
Canvas-Tokens sind an Canvas-Berechtigungen gebunden. Wenn Ihr Canvas-Konto gelöscht wird oder Sie nicht mehr Administrator sind, werden auch Ihre Tokens widerrufen.
Option Eins: Einen Anruf über HTTPS tätigen
Alle API-Aufrufe müssen über HTTPS erfolgen. Das Zugriffstoken muss als URL-Abfrageparameter in jeden API-Aufruf an Canvas eingefügt werden. Der Endpunkt zum Abrufen der Kursliste des Benutzers lautet beispielsweise:
Um Bobs Liste abzurufen, und falls Bobs Zugriffstoken "token_of_magical_power" wäre, dann würden Sie Folgendes aufrufen:
- GET /api/v1/courses.json?access_token=token_of_magical_powers
Ein detailliertes Beispiel für die Verwendung der API finden Sie in der API-Grundlagendokumentation auf GitHub.
Eine weitere Möglichkeit, einen API-Aufruf mit einem Zugriffstoken durchzuführen, besteht darin, dieses dem Anfrageheader hinzuzufügen. Bei Verwendung von curl (einem Kommandozeilenprogramm zum Ausführen von API-Anfragen) geben Sie das Zugriffstoken wie folgt an.
Beachten Sie, dass das access_token überhaupt nicht in der URL enthalten ist.
Ein Beispiel finden Sie in der API-Dokumentation .