Como autorizar chamadas de API no Swagger

Autorize e teste chamadas de API do Orchestrator usando a interface integrada do Swagger.

Acesso ao Swagger

Se você estiver usando o Swagger para experimentar nossa API, basta fazer login em sua instância do Orchestrator em uma guia separada.

A definição do Swagger da API do Orchestrator pode ser acessada adicionando o sufixo /swagger/ui/index#/ ao URL do Orchestrator. Por exemplo, https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_ /swagger/ui/index#/.

Como obter um token de acesso

Para autorizar chamadas de API por meio da interface gráfica do Swagger para serviços do Orchestrator, execute as seguintes etapas:

1. Consulte o botão Autorizar no canto superior direito da página API do Orchestrator. Se o cadeado estiver aberto, você não está autorizado.
2. Selecionar Autorizar. A janela Autorizações disponíveis é exibida.
   Observação:

   Atualmente, oferecemos suporte a um esquema de autorização chamado OAuth2.

   
3. Todos os escopos são pré-selecionados para que você possa experimentar todos os endpoints na API do orquestrador. Limpe-os se quiser restringir o acesso a determinadas APIs.
4. Selecionar Autorizar. Uma nova janela é exibida confirmando que você foi autorizado.
5. Após fazer isso, selecione Fechar ou X para fechar a janela Autorizações disponíveis. O botão Autorizar mostra um cadeado fechado, o que significa que você está autorizado.

Envio de solicitações

Enquanto autorizado, você pode fazer solicitações nos recursos da API do Orchestrator da seguinte maneira:

1. Expanda um recurso de API do Orchestrator com o qual você deseja executar uma operação. O cadeado fechado significa que você está autorizado.
   
2. Na janela método expandido, selecione Experimentar.
3. Especifique valores de parâmetro, se necessário.
4. Selecionar Executar. A solicitação é executada. Um cabeçalho de autorização do portador é usado automaticamente para suas solicitações.
   

Geração de um token de acesso

Quando o token de acesso expira, você recebe uma resposta 401: You are not authenticated! . O cabeçalho de autorização do portador ainda está presente para suas solicitações, mas o token de acesso expirou. Quando isso acontecer, você precisa invalidar o token expirado e gerar um novo token de acesso:

1. Consulte o botão Autorizar no canto superior direito da página API do Orchestrator. O bloqueio deve ser fechado.
2. Selecione Autorizar e, na página Autorizações disponíveis exibida, selecione Sair para revogar o token expirado.
   
3. Feche a janela Autorizações disponíveis clicando em Fechar ou X e, em seguida, obtenha um token de acesso conforme descrito na seção Obtenção de um token de acesso.

Revogar acesso

Quando terminar de trabalhar com a IU Swagger, você deve invalidar o token de acesso que você usou:

1. Consulte o botão Autorizar no canto superior direito da página API do Orchestrator. O bloqueio será fechado, ou seja, agora você está autorizado.
2. Selecione Autorizar e, na página Autorizações disponíveis exibida, selecione Sair.
3. Feche a janela Autorizações disponíveis clicando em Fechar ou no X. O botão Autorizar mostra um cadeado aberto, o que significa que você não tem autorização.