Este artigo apresenta as etapas para gerar e baixar ordens de serviço usando a API Scantrust. O token UAT deve ter acesso às seguintes permissões:
- scans_download
Importante:
Para acessar a API REST do Scantrust, você pode usar uma plataforma de API como o Postman. Esta é a plataforma de API mais popular do mundo, com mais de 17 milhões de usuários e 500.000 organizações em todo o mundo. A ferramenta oferece um ambiente flexível e colaborativo que permite projetar, desenvolver, documentar e testar suas APIs com mais rapidez.
Você pode experimentar o aplicativo da web ou baixar e instalar este aplicativo neste link: https://www.postman.com/downloads/ Em qualquer caso, você deve se registrar com um endereço de e-mail válido.
Observação: No contexto do Scantrust, o Postman deve ser usado apenas para fins de teste. Não deve ser usado em cenários reais ou implantações de projetos.
Etapas para configurar o Postman
1. Abra o Postman. Na página inicial, você verá o seguinte:
2. Em seguida, clique na aba chamada: “Espaços de trabalho”, no canto superior esquerdo:
3. Em seguida, clique na opção “Meu Espaço de Trabalho”:
4. Quando estiver no seu espaço de trabalho, clique no sinal “+” da seguinte maneira:
5. Após isso, uma nova aba aparecerá com uma requisição de API pré-configurada: GET:
6. Agora é importante configurar a autorização da API. Para isso, clique na aba "Autorização":
7. Em seguida, clique na seção "Tipo" e selecione a opção "Chave de API", conforme abaixo:
8. Agora, digite a palavra "Autorização" no campo de chave, copie seu token UAT do portal ST e cole-o no campo "Valor", incluindo os caracteres UAT. UAT [token tu], deixando uma barra de espaço entre a string UAT e o token:
9. Em seguida, vá até a aba “Body”, selecione “raw” e selecione “JSON”:
Etapas para baixar dados digitalizados
Para baixar seus dados de digitalização, você precisa:
- Encontre o ID da campanha
- Defina o período de tempo para filtrar as verificações com base em um intervalo de tempo.
Como encontrar o ID da sua campanha:
1. Faça login no portal e clique em CAMPANHAS no menu de hambúrguer à esquerda.
2. Na campanha cujos dados você deseja baixar, clique no ícone DASHBOARD:
3. Quando o painel abrir, a URL no navegador será exibida:
https://portal.scantrust.com/#/dashboard?tabIndex=0&campanhaId=126&página=1
O ID da campanha está em negrito.
4. Em seguida, você precisa filtrar as informações que deseja baixar. Todos os filtros do painel também podem ser usados para filtrar as análises baixadas. Por exemplo, se você quiser filtrar e baixar todas as análises de campaña 195,que foram marcados fora do mercado e o que eles têm mercado esperado estabelecido na "China" (Zh). Para fazer isso, você precisa configurar uma solicitação GET com a seguinte URL:
5. Então você deve obter uma resposta 200 OK:
Comentários