Saiba como criar um aplicativo do Autodesk Platform Services (APS), gerar um token de acesso do OAuth 2.0 usando o Postman e utilizar o token para fazer uma solicitação à API v2 do Autodesk Fusion Operations.
A API v2 do Autodesk Fusion Operations usa o método de autenticação do Autodesk Platform Services (APS). Você pode consultar a documentação da API v2 do Fusion Operations aqui.
Criar um aplicativo do APS
1. Vá para a página My Apps (Meus aplicativos) do APS e selecione Create application (Criar aplicativo).
2. Especifique um nome para o aplicativo (1), selecione Traditional Web App (Aplicativo Web tradicional) (2) como o tipo de aplicativo e clique em Create (Criar) (3).
3. Configure o aplicativo da seguinte maneira: substitua o Callback URL (URL de retorno de chamada) por https://oauth.pstmn.io/v1/browser-callback (1), selecione Fusion Operations API (API do Fusion Operations) e User Profile API (API do perfil do usuário) em API Access (Acesso à API) (2) e clique em Salve changes (Salvar alterações) (3).
Conectar o aplicativo do APS ao Fusion Operations
1. No aplicativo do APS, copie o Client ID (ID do cliente).
2. No Fusion Operations, abra o menu do usuário e selecione Integrations (Integrações).
3. Em Fusion Operations API (API do Fusion Operations), clique em Configure (Configurar).
4. Clique em Add (Adicionar) para criar um novo link para um aplicativo do APS.
5. Insira um Name (Nome) para a integração, cole o Client ID (ID do cliente) do APS e clique em Save Link (Salvar link).
Configurar o OAuth 2.0 e gerar o token de acesso no Postman
Para obter mais informações sobre como gerar um token de acesso de três pernas, consulte o artigo Gerar um token de três pernas (em inglês).
1. No Postman, crie uma nova Collection (Coleção), abra a guia Authorization (Autorização) e selecione OAuth 2.0 como o tipo de autorização.
2. Em Configure New Token (Configurar novo token), especifique um Token Name (Nome do token) e selecione Authorization Code (Código de autorização) como o tipo de concessão.
3. Configure os URLs do OAuth da seguinte maneira:
URL de retorno de chamada:
https://oauth.pstmn.io/v1/browser-callbackURL de autorização:
https://developer.api.autodesk.com/authentication/v2/authorizeURL do token de acesso:
https://developer.api.autodesk.com/authentication/v2/tokenNo aplicativo do APS, copie e insira o Client ID (ID do cliente) e o Client Secret (Segredo do cliente) no Postman.
Digite
data:readem Scope (Escopo). Isso permitirá que você obtenha dados de Fusion Operations. Se no futuro você também desejar editar os dados, digitedata:writeem Scope (Escopo).Deixe State (Estado) em branco e selecione Send as Basic Auth header (Enviar como cabeçalho de autorização básica) em Client Authentication (Autenticação do cliente).
Efetue login com sua conta Autodesk no navegador e autorize o aplicativo.
3. Depois que o token for gerado com êxito, clique em Use Token (Usar token) para aplicá-lo à coleção do Postman.
Agora o token de acesso está pronto para ser usado para autenticar solicitações para a API v2 do Fusion Operations.
Exemplo: usar o token de acesso para recuperar produtos usando a API v2 do Fusion Operations
Para obter uma lista completa dos pontos de extremidade disponíveis da API v2, consulte a referência da API REST do Fusion Operations.
1. Crie uma nova solicitação no Postman, selecione GET como o método de solicitação e insira o ponto de extremidade de produtos: https://api.aps.autodesk.com/fusion-operations/v2/products.
2. Abra a guia Authorization (Autorização) e assegure-se de que o OAuth 2.0 seja herdado da coleção, permitindo que a solicitação use o token de acesso gerado nas etapas anteriores. Clique em Send (Enviar).
3. Uma solicitação bem-sucedida retorna a resposta 200 OK com os produtos disponíveis em sua conta do Fusion Operations.
Caso ainda tenha dúvidas, entre em contato conosco pelo Live Chat ou fale diretamente com o gerente da sua conta.
Precisa de ajuda? Peça para um especialista do Fusion Operations entrar em contato com você aqui.