Criar um Tarefa de API

Você pode criar um Tarefa de API com diversos pacotes sem compatibilidade na Automation Anywhere Control Room.

Pré-requisitos

Você deve ter uma licença do Criador de bots.
Este tópico descreve como criar uma Tarefa de API usando uma amostra de API que recebe um CEP dos EUA como entrada e retorna o nome do local e do estado como saída. Você pode criar um Tarefa de API com as ações que são específicas para seu caso de uso.

Procedimento

  1. Faça login na instância da Automation Anywhere Control Room como o Bot Creator.
  2. Crie um novo Tarefa de API:
    1. No painel da esquerda, clique em Automação.
    2. Clique em Criar novo > Tarefa de API .
    3. Na janela Criar tarefa de API , insira o nome do Tarefa de API.
    4. Aceite o local da pasta padrão: \Bots\.
      Para alterar o local de armazenamento do Tarefa de API, clique em Escolher e siga as instruções.
    5. Clique em Criar e editar.
  3. Crie uma variável ZipCode como uma entrada que será usada no URL do CEP.
  4. Use a ação Método GET para recuperar o local e o estado de um CEP.
    Nota: Pacotes pré-construídos estão disponíveis para os aplicativos corporativos mais comuns. Para obter uma lista dos pacotes suportados, consulte .
    1. Clique duas vezes ou arraste a REST Web Services > Método GET ação.
      Serviços da Web Get - Método Get
    2. Digite o seguinte URI. $ZipCode$ no URI é a variável de entrada criada na Etapa 3. 
      https://api.zippopotam.us/us/$ZipCode$
      Nota:

      Você pode configurar múltiplas APIs com uma única Tarefa de API. Este pode simplificar sua automação e reduzir a necessidade de ter múltiplas tarefas separadas. Por exemplo, você pode chamar a API 1 para buscar dados do produto, a API 2 para buscar dados de preços e, em seguida, API 3 para criar uma cotação dentro da mesma Tarefa de API.

    3. Na lista suspensa Modo de autenticação, selecione Sem autenticação porque este ponto final não requer autenticação.
      Nota: Normalmente, os endpoints exigem autenticação para garantir que somente aplicativos autorizados possam acessar os dados. Selecione um mecanismo de autenticação apropriado para permitir o acesso ao endpoint que você quer acessar.
    4. Crie a variável pDictZipCodeApiResponse no campo Atribuir a saída a uma variável. Para mais informações sobre como criar uma variável, consulte Criar uma variável.
      Nota:
      • A resposta completa da API JSON é atribuída a esta variável de dicionário: pDictZipCodeApiResponse.
      • Os seguintes tipos de variáveis não são suportados para Tarefas de API: Arquivo, Janela e Formulário.
  5. No painel Ações, arraste a ação JSON > Iniciar sessão e solte-a na tela abaixo da ação Serviços Web REST.
    1. No campo Fonte de dados, selecione Texto e digite$pDictZipCodeApiResponse{Corpo}$.
    2. No campo Sessão do objeto JSON, selecione Sessão local e insira Padrão.

      Tarefa de API Dicionário
      Agora você tem todo o Body. A próxima tarefa é extrair os campos obrigatórios do corpo. A seguir, um exemplo de Corpo JSON:
      {
    "post code": "90210",
    "country": "United States",
    "country abbreviation": "US",
    "places": [
        {
            "place name": "Beverly Hills",
            "longitude": "-118.4065",
            "state": "California",
            "state abbreviation": "CA",
            "latitude": "34.0901"
        }
    ]
}
  6. Extraia o place name do JSON.
    1. No painel Ações, arraste a ação Json > Obter valor do nó ação e solte-a na tela abaixo da ação Json > Sessão de estado.
    2. Especifique os nós que serão extraídos. Por exemplo, para extrair o local, você pode usar places[0].["nome do local"]
    3. Crie uma variável Local e atribua a saída a essa variável.
  7. Extraia o estado do JSON.
    1. No painel Ações, arraste a ação Json > Obter valor do nó ação e solte-a na tela abaixo da ação Json > Sessão de estado.
    2. Especifique os nós que serão extraídos. Por exemplo, para extrair o local, você pode use places[0].["estado"]
    3. Crie uma variável Estado e atribua a saída a essa variável.
  8. Clique em Salvar.
    Para testar o Tarefa de API, clique em Depurador. Ao fazer a depuração, o dispositivo local é usado para executar o Tarefa de API. O Tarefa de API criado neste exemplo recupera o Local e Estado para qualquer entrada de código postal.