Saiba como criar uma aplicação Nos Serviços de Plataforma da Autodesk (APS), gerar um token de acesso OAuth 2.0 com o Postman e utilizar o token para fazer um pedido ao Autodesk Fusion Operations API v2.
O Autodesk Fusion Operations API v2 utiliza o método de autenticação dos Serviços de Plataforma da Autodesk (APS). Pode consultar a documentação Fusion Operations API v2 aqui.
Criar uma aplicação APS
1. Aceda à página My Apps (As minhas aplicações) e selecione Create application (Criar aplicação).
2. Introduza um nome para a aplicação (1), selecione Traditional Web App (Aplicação Web tradicional) (2) como o tipo de aplicação e clique em Create (Criar) (3).
3. Configure a aplicação como se segue: substitua o Callback URL (URL de redirecionamento) por https://oauth.pstmn.io/v1/browser-callback (1), selecione Fusion Operations API e User Profile API (Perfil do utilizador API) em API Access (2) (Acesso API) e clique em Save changes (Guardar alterações) (3).
Ligue a aplicação APS ao Fusion Operations.
1. A partir da aplicação APS, copie o Client ID (ID do cliente).
2. No Fusion Operations, abra o menu de utilizador e selecione Integrations (Integrações).
3. Em Fusion Operations API, clique em Configure (Configurar).
4. Clique em Add (Adicionar) para criar uma nova ligação para uma aplicação APS.
5. Introduza um Name (Nome) para a integração, cole o APS Client ID (ID do cliente) e clique em Save Link (Guardar ligação).
Configure o OAuth 2.0 e gere o token de acesso no Postman
Para mais informações sobre como gerar um token de acesso de três níveis, consulte o artigo Gerar um token de três partes.
1. No Postman, crie uma nova Collection (Coleção), abra o separador Authorization (Autorização) e selecione OAuth 2.0 como o Tipo de autenticação.
2. Em Configure New Token (Configurar token novo), introduza um Token Name (Nome do token) e selecione Authorization Code (Código de autorização) como o Tipo de concessão.
3. Configure os URL do OAuth como se segue:
URL de redirecionamento (Callback):
https://oauth.pstmn.io/v1/browser-callbackURL de autenticação:
https://developer.api.autodesk.com/authentication/v2/authorizeURL do token de acesso:
https://developer.api.autodesk.com/authentication/v2/tokenA partir da sua aplicação APS, copie e introduza o Client ID (ID de cliente) e o Client Secret (Segredo de cliente) no Postman.
Introduza
data:readem Scope (Âmbito), isto permitir-lhe-á obter dados do Fusion Operations. Se no futuro também quiser editar os dados, introduzadata:writeem Scope (Âmbito).Deixe o State (Estado) em branco e selecione Send as Basic Auth header (Enviar como cabeçalho Auth básico) em Client Authentication (Autenticação de cliente).
Inicie sessão com a sua conta Autodesk no browser e autorize a aplicação.
3. Após a criação bem-sucedida do token, clique em Use Token (Utilizar token) para o aplicar na coleção do Postman.
Agora, o token de acesso está pronto para ser utilizado na autenticação de pedidos no Fusion Operations API v2.
Exemplo: utilize o token de acesso para obter produtos com o Fusion Operations API v2
Para obter uma lista completa dos pontos finais API v2 disponíveis, consulte Fusion Operations REST API Reference.
1. Crie um novo pedido no Postman e selecione GET como método de pedido e introduza o ponto final Products (Produtos): https://api.aps.autodesk.com/fusion-operations/v2/products.
2. Abra o separador Authorization (Autorização) e certifique-se de que o OAuth 2.0 é herdado da coleção, permitindo que o pedido utilize o token de acesso gerado nos passos anteriores e clique em Send (Enviar).
3. Um pedido bem-sucedido devolve uma resposta 200 OK com os Produtos disponíveis na sua conta Fusion Operations.
Se tiver alguma dúvida, não hesite em contactar-nos através do nosso chat em direto ou contacte diretamente o seu gestor de conta.
Precisa de ajuda? Peça a um especialista do Fusion Operations para entrar em contacto consigo aqui.