O Blackboard fornece acesso público a um conjunto de APIs REST que permitem que os desenvolvedores criem aplicativos personalizados que acessam o Blackboard Learn.
Para saber mais sobre nossos parceiros de integração, visite o Catálogo de aplicativos da Anthology.
Por que APIs REST?
O uso de APIs REST permite que um desenvolvedor crie aplicativos que são acoplados apenas vagamente ao servidor do Blackboard Learn. Podem residir em qualquer lugar. Permitem que o servidor sirva as informações sem correr o risco de uma possível interferência no servidor.
Segurança com as APIs REST
As APIs REST podem operar sob uma variedade de modelos de segurança. A autorização de API REST do Blackboard usa o padrão do setor OAuth 2.0. Ele permite fazer solicitações com base em privilégios definidos pelo administrador do Blackboard Learn. Além disso, os aplicativos podem usar uma variação de três fatores do protocolo. Essa abordagem autentica os aplicativos como usuários específicos do Blackboard Learn sem compartilhar as credenciais dos usuários. Os usuários fazem logon para permitir que o aplicativo atue em seu nome. Em seguida, o aplicativo adquire apenas o mesmo nível de acesso do usuário.
Como prática recomendada, conceda aos usuários da integração os privilégios mínimos necessários para usar a ferramenta integrada — e não permissões completas de administrador do sistema.
O que você pode fazer com as APIs REST?
Você pode solicitar acesso às APIs REST do Blackboard por meio do Portal do desenvolvedor. Depois de registrar seu aplicativo, geraremos uma chave e um segredo exclusivos para que você possa fazer chamadas e obter os dados necessários para integrar seu aplicativo à nossa plataforma. Aplicativos baseados em REST podem acessar, por exemplo:
- avisos
- Cursos
- conteúdo
- anexos
- exercícios
- notas
Para ver uma lista completa dos pontos de extremidade REST disponíveis para desenvolvedores, consulte a documentação da API do Learn.
Saiba mais sobre A estrutura de API REST do Blackboard
Saiba mais sobre os primeiros passos com a API REST do Learn
Registrar uma integração de REST no Blackboard Learn
O Blackboard Learn suporta a integração de aplicativos externos criados com o uso das APIs REST do Blackboard Learn. Antes de poder usar uma integração com o Blackboard Learn, um administrador deve registrá-la no Blackboard Learn.
Antes de começar a registrar o aplicativo, você deve obter um código do aplicativo. O desenvolvedor pode fornecer o código diretamente para o administrador ou agrupá-lo com a documentação de suporte do aplicativo.
- No Painel do administrador, em Integrações, selecione Integrações de API REST.
- Selecione Criar integração.
- Em Código do aplicativo, insira o código do aplicativo fornecido ao registrar um aplicativo no Portal do desenvolvedor do Anthology.
- Ao lado de Usuário do Learn, selecione Navegar. Pesquise o usuário Blackboard pelo qual a integração deve atuar. Normalmente, uma integração atua como Administrador ou outro usuário criado para o gerenciamento da integração. O ideal é que o usuário tenha apenas as permissões necessárias para a integração funcionar corretamente.
- Para integração de terceiros, configure Acesso do usuário final como Sim. Os usuários finais entram com o próprio código do Blackboard Learn para usar a integração. O acesso de cada usuário é, então, limitado às respectivas permissões. Se você definir Acesso do usuário final como Não, a integração sempre terá acesso como se fosse o usuário do Blackboard Learn indicado no formulário.
- Selecione Enviar para salvar suas configurações.