Guias Canvas (pt-br)Guia do Administrador APIComo eu obtenho um token de acesso à API para um conta?

Como eu obtenho um token de acesso à API para um conta?

O Canvas permite acesso programático a alguns pedaços de informação através da API do Canvas. Chamadas à API requerem autorização, e são feitas em nome de um usuário autorizado.

Você pode visualizar a documentação da API do Canvas mais atualizada, que pode ou não ser exata para instâncias do Canvas instaladas localmente. Se você não está utilizando o serviço Canvas Cloud, converse com seu administrador do site sobre como obter o conjunto de documentação da API. A documentação pode ser gerada executando rake doc:api no console.

Uma vez que você tenha um usuário no Canvas, você pode criar um destes tokens de acesso para testar em seus projetos de desenvolvimento. Este token deve ser incluído como um parâmetro de consulta da URL em qualquer chamada à API feita para o Canvas.

Os tokens do Canvas estão lainhados com as permissões do Canvas. Se sua conta do Canvas for excluída ou se você já não for um administrador, seus tokens também serão revogados.

Nota: Tokens de acesso da API só podem ser removidos na página de configurações do usuário. Os usuários com privilégios mascarados não podem remover o token em nome do usuário.

Abrir Configurações do Usuário

Abrir Configurações do Usuário

Na Navegação Global (Global Navigation), clique no link Conta (Account) [1], depois clique no link Configurações (Settings) [2].

Adicionar Novo Token de Acesso

Adicionar Novo Token de Acesso

Localize Integrações Aprovadas (Approved Integrations) e clique no botão Adicionar Novo Token de Acesso (Add New Access Token).

Inserir Informação do Token

Inserir Informação do Token

Insira o motivo para o token no campo Objetivo [1]. Configure uma data de expiração para o token clicando no ícone Calendário (Calendar) [2]. Se o token não tem expiração, deixe o campo de expiração em branco. Clique no botão Gerar Token (Generate Token) [3].

Copiar Token

Copiar Token

Copie um token dado a você [1]. Para gerar novamente um novo token, clique no botão Gerar Token Novamente (Regenerate Token) [2]. Para fechar a janela, clique no ícone do X [3].

Nota: Você só receberá o token de acesso uma vez. Se você não o copiou, você terá que criar um novo token.

Visualizar Integrações Aprovadas

Visualizar Integrações Aprovadas

Visualizar as integrações aprovadas. Você pode remover uma integração clicando no ícone Excluir (Delete).