Om du har genererat en API-åtkomsttoken, kan du använda den för att göra API-anrop.
Canvas-tokens stäms av med Canvas-behörigheter. Om ditt Canvas-konto har raderats eller om du inte längre är administratör kommer dina tokens att återkallas.
Alternativ ett: Gör ett anrop till HTTPS
Alla API-anrop måste också göras till HTTPS. Denna åtkomsttoken måste inkluderas som en URL-frågeparameter i API-anrop till Canvas. Till exempel är slutpunkten för att hämta användarens kurslista:
- GET /api/v1/courses.json
För att hämta Bobs kurslista och om Bobs åtkomsttoken är "token_of_magical_power" skulle du anropa
- GET /api/v1/courses.json?access_token=token_of_magical_powers
För ett detaljerat exempel på användning av API:t, se Grundläggande dokumentation om API på Github.
Alternativ två: Gör ett anrop med en begäranderubrik
Det andra sättet att göra ett API-anrop med en åtkomsttoken är att lägga till den i begäranderubriken. Om du använder curl (ett kommandoradsprogram som kan användas för att göra API-begäranden) ska du specificera åtkomsttoken så här:
- curl -H "Authorization: Bearer <token>" 'https://<canvas>/api/v1/accounts/<account_id>/courses.json'
Observera att access_token inte finns i URL:en.
Se exemplet på webbplasten för API-dokumentationen.
