Skip to main content

Como usar o Postman

Você pode usar o Postman para testar a API V3 do Server.

Pré-requisitos:

Adicionar a API ao Postman

Para testar a API do Server, importe-a para o Postman.

  • Primeiro, você precisa obter o link que será usado para importar a API V3 do Server. Para encontrar o link, vá para a IU do Server, selecione o ícone do ponto de interrogação no canto superior direito e selecione Documentação da API . Isso leva você para a página da API V3 do Swagger.

    D864A4F19A7E2F0B01BD1B2F6D96039F.png
  • Anote o endereço da documentação da API que você encontra na página Swagger.

    Note the address of the API documentation you find on the Swagger page. 
  1. No Postman, vá para Coleções e selecione Importar .

    Import API to Postman using a link.
  2. Selecione Link e insira a URL da API do Server que você anotou na etapa 2 e selecione Continuar . E57CB8F28A077B7BE4FBB42086B0BF1F.png

  3. Agora você pode ver a API V3 do Alteryx Server na guia Coleções .

    5289017C498626BCC472ED477FAAB963.png

Configurar autorização

Para poder enviar suas solicitações, é necessário configurar a autorização no Postman.

  • Vá para Collections e selecione Alteryx Server API V3 .

  • Na guia Autenticação , selecione o tipo OAuth 2.0 .

    4C6D43513F891F48BA15BE378F5169DC.png
  • Configure o Token atual da seguinte maneira:

    AD273A073BE2399E360B94B3F9EB79C6.png
  1. Na seção Configurar novo token , configure o seguinte:

    1. Opcionalmente, digite um Nome de token .

    2. Em Tipo de concessão , selecione Credenciais do cliente .

    3. Em URL do token de acesso , insira o ponto de extremidade para o servidor de autenticação. Para encontrar o ponto de extremidade, vá para Swagger e procure o URL do token . Para obter mais informações, visite a seção Como autenticar na página de ajuda Configuração e autorização da API .

      Find the Token URL in Swagger.

      Exemplo da configuração final do token:

      How the API authorization looks like in Postman.
    4. Em ID do cliente , digite a Chave de acesso à API localizada em "Meu perfil" na IU do Server.

    5. Em Segredo do cliente , digite a Chave secreta da API localizada em "Meu perfil" na IU do Server.

    6. Em Autenticação de cliente , selecione Enviar como cabeçalho de autenticação básica .

  2. Selecione Obter novo token de acesso .

Configurar ambiente

Não se esqueça de configurar os mesmos valores em Ambiente .

  1. Selecione o ícone de olho no canto superior direito e, em seguida, selecione Adicionar para "Ambiente".

  2. Insira o nome do seu ambiente.

  3. Insira o mesmo URL base, segredo e chave de API usados na etapa 4 da seção "Configurar autorização".

  4. Insira o URL para o ambiente. Você pode encontrá-loem Configurações do sistema Alteryx como o Endereço de base . Consulte a etapa 4 da seção "Configurar autorização".

  5. Clique em Salvar .

Enviar solicitações

Você pode testar a API do Server no Postman – autorizar e enviar suas solicitações ou explorar diferentes tipos de código de suas solicitações.

Exemplo

Digamos que você gostaria de recuperar uma lista de ativos que um usuário possui.

  1. Primeiro, você precisa saber o ID de usuário específico.

    1. Vá para Coleções e selecione API V3 do Alteryx Server .

    2. Selecione Usuários e, em seguida, selecione OBTER Pesquisar registros de usuários .

    3. Na guia Parâmetros , você pode usar os parâmetros para pesquisar em todos os registros de usuários.

    4. Para enviar a solicitação, selecione Enviar e obtenha resultados com base nos parâmetros inseridos.

    5. Nos resultados, copie o ID do usuário para o qual deseja recuperar a lista de ativos.

  2. Em outra guia, abra outra solicitação. Vá para Usuários e selecione {id} .

  3. Selecione OBTER Recuperar uma lista completa de ativos que um usuário possui . Insira o ID de usuário obtido através da solicitação anterior para obter a lista de ativos deste usuário.

EF76F0DE8E6C3302DC8217A5E26730F2.png

Nota

Ao enviar uma solicitação via Postman, não se esqueça de autorizá-la. Para atualizar a solicitação, você tem duas opções:

  • Em Tipo , selecione OAuth2 e, em seguida, selecione um de seus tokens disponíveis.

3E01CCA547A640B4F108491EB7F65ADD.png
  • Em Tipo , selecione Herdar autenticação do pai . A autorização configurada para toda a coleção será usada.

Authorization of a request using Inherited from parent.