O conector Rest API transforma os dados em um formato JSON achatado. Especificamente, o conector achata todos os dados aninhados em uma única camada de pares de chaves em uma única tabela.
Observação

O resultado máximo em JSON é de 10 MB e os dados não podem ter mais de 1.000 colunas.

Configurar uma nova conexão

Complete os passos a seguir para configurar uma conexão no Minitab Connect.
  1. Na tela, selecione o Adicionar botão abaixo Tabelas de Home .
  2. Em Conjuntos de dados, insira a API Rest e selecione o conector dos resultados.
  3. Insira um Nome que identifica a conexão.
  4. Em Variáveis, insira até 15 pares-chave-valor para armazenar e reutilizar valores. Insira a chave na primeira caixa e o valor na segunda. O nome da chave é limitado a 100 caracteres e só pode conter letras, números, hífens (-) e sublinhados (_). O conector valida e executa o valor como uma instrução SQL se começar com um parêntese à esquerda e terminar com um parêntese à direita.

    Quando você armazena um valor como variável, pode consultá-lo várias vezes e só precisa atualizá-lo em um lugar. Por exemplo, se você tiver a mesma URL em mais de uma solicitação, mas a URL pode mudar, insira base_url como chave. Depois, insira www.example.com como valor e use {{base_url}} para referenciar a variável nas suas solicitações. Se a URL mudar, você pode alterar o valor de base_url para atualizar a nova URL em todas as suas requisições usando a mesma conexão automaticamente.

  5. Em Autenticação, selecione uma das seguintes opções.
    Autenticação básica
    Insira as credenciais do serviço web RESTful.
    Chave/token de API
    Insira a chave e o valor da API. Tipo de parâmetro de autenticação desejado Se você selecionar Parâmetro de cabeçalho , pode fazer pedidos GET e POST. Se você selecionar Parâmetro do corpo , só pode fazer pedidos POST.
    Token Bearer
    Insira o Token.
    Token JWT
    Selecione para gerar tokens JWT e adicione-os à solicitação. Tipo de parâmetro de autenticação desejado Se você selecionar Parâmetro de cabeçalho , pode fazer pedidos GET e POST. Se você selecionar Parâmetro do corpo , só pode fazer pedidos POST.
    De Algoritmo, selecione um algoritmo HS, RSou ES . Se você selecionar HS, digite um Segredo para usar com o algoritmo. Se você selecionar RS ou ES, Connect cria um Chave pública JWT depois que você salva a conexão.
    OAuth 2.0
    Selecione para acessar dados com OAuth 2.0. Para mais informações sobre as opções desse método de autenticação, acesse a seção Configurar uma nova conexão com OAuth 2.0.
    Nenhum
    Selecione se seu serviço web não exige nome de usuário, senha ou chave API
  6. Selecionar Salvar.

Depois de salvar a conexão, o Connect exibe opções para importar dados em uma nova tabela. Comece na etapa 4 da seção Criar uma tabela com dados de uma seção de conexão para mais informações sobre como importar dados para criar uma tabela.

Configurar uma nova conexão com OAuth 2.0

Complete os passos a seguir para configurar uma conexão no Minitab Connect com o OAuth 2.0 método de autenticação. Acessar dados com OAuth 2.0 geralmente envolve algumas requisições entre Connect e a API.
  1. Na tela, selecione o Adicionar botão abaixo Tabelas de Home .
  2. Em Conjuntos de dados, insira a API Rest e selecione o conector dos resultados.
  3. Insira um Nome que identifica a conexão.
  4. Em Autenticação, selecione OAuth 2.0.
  5. Tipo de parâmetro de autenticação desejado Se você selecionar Parâmetro de cabeçalho , pode fazer pedidos GET e POST. Se você selecionar Parâmetro do corpo , só pode fazer pedidos POST.
  6. Em Tipo de concessão, selecione uma das seguintes opções.
    Código de autorização
    Selecione autenticar com o provedor de serviço da API. Um código de autorização é enviado de volta ao aplicativo cliente, extraído e trocado com o provedor por um token de acesso para autenticar futuras solicitações.
    Implícito
    Selecione para devolver um token de acesso sem exigir a etapa extra do código de autorização. Isso torna a segurança menos segura.
    Credenciais de senha
    Selecione enviar um nome de usuário e senha diretamente do cliente. Se você selecionar esse tipo de subsídio, precisa inserir o Nome de usuário e Senha para o seu provedor de API.
    Credenciais do cliente
    Use para acessar dados associados à aplicação cliente.
  7. A seguir está a lista completa de opções para solicitar um novo token de acesso. Elas dependem do tipo de bolsa que você oferece.
    URL de retorno de chamada
    Você deve adicionar essa URL aos URLs de Callback registrados do seu aplicativo.
    URL de autenticação
    Insira o endpoint do servidor de autorização que você quer usar para obter o código de autorização. Inclua quaisquer parâmetros não padronizados que o serviço exigir.
    URL do token de acesso
    Insira o endpoint do servidor de autorização que você quer usar para obter o token de acesso.
    URL do token de atualização
    Insira o endpoint do servidor de autorização que você deseja usar para atualizar o token de acesso se ele for diferente do URL do token de acesso.
    ID do cliente
    O ID do seu aplicativo cliente que você registrou com o provedor da API.
    Segredo do cliente
    O segredo do cliente que você recebeu ao se registrar com o provedor da API.
    Escopo
    O escopo da solicitação de acesso. Separe múltiplos escopos com um espaço.
    Autenticação do cliente
    Selecione como você quer transmitir as credenciais do cliente ao solicitar um token de acesso.
  8. Se você selecionou Código de autorização ou Implícito como seu tipo de subsídio, deve selecionar Clique para autorizar antes de poder salvar a conexão.
  9. Selecionar Salvar.

Depois de salvar a conexão, o Connect exibe opções para importar dados em uma nova tabela. Comece no passo 4 da seção a seguir para obter mais informações sobre como importar dados para criar uma tabela.

Crie uma tabela com dados de uma conexão

Complete os passos a seguir para importar um arquivo de dados de uma API e criar uma nova tabela no Connect. Se você usar uma variável em uma caixa de entrada, pode passar o mouse sobre a variável para visualizar o valor. No entanto, você só pode referenciar uma variável na configuração da tabela, não na conexão. Você deve definir a variável e salvar a conexão para referenciar uma variável. Para mais informações, veja o passo 4 na seção "Configurar uma nova conexão".
  1. Na tela, selecione o Adicionar botão abaixo Tabelas de Home .
  2. Em Conjuntos de dados, insira a API Rest e selecione o conector dos resultados.
  3. Em Conexão, selecione a conexão Rest API que você configurou anteriormente. Se você ainda não configurou uma conexão antes, selecione Nova conexão e siga os passos da seção anterior.
  4. No painel à esquerda, digite a Nome que identifica a tabela e selecione a Pasta para salvar a tabela.
  5. Em Frequência de atualização, especifique com que frequência você quer que Connect atualize a tabela. Você pode importar os dados uma vez ou fazer o Connect importar continuamente os dados em um intervalo de tempo definido. O Connect cria automaticamente um fluxo para sua importação. Se você selecionar Uma vez, pode usar o fluxo em um momento posterior para rodar automaticamente a importação novamente.
  6. Em URL, insira a URL base da solicitação. Você vai adicionar parâmetros depois.
  7. A partir Tipo de requisiçãode , selecione uma requisição HTTP GET ou uma requisição HTTP POST .
  8. Em Profundidade máxima da matriz, selecione a profundidade máxima na qual o Connect converte nós de dados JSON em colunas de tabela. Os dados da string JSON tornam-se o resultado do valor da célula quando Connect atinge a profundidade máxima. Por padrão, a profundidade máxima do array é 5.
  9. Selecione Próximo.
  10. Em Parâmetros do cabeçalho da requisição e Parâmetros do corpo da requisição, insira os parâmetros de requisição que você deseja enviar. Se você usar uma variável, pode passar o mouse sobre a variável para visualizar o endpoint da URL.
  11. Inicialmente, nenhum campo está disponível. Selecione Adicionar parâmetro para adicionar pares de chaves aos parâmetros da URL da solicitação.
  12. Em Chave de matriz para registros (caminho raiz), insira o caminho separado por vírgula até o nó.
  13. Selecione A resposta separa os registros em várias páginas para adicionar variáveis de paginação. Depois, a partir de Configuração de variáveis de paginação, selecione uma das seguintes opções. Com qualquer uma das opções, você pode analisar no máximo 100 páginas.
    Parâmetro do link da próxima página
    Use quando você continuar a partir da resposta anterior da API e passar pelos resultados uma página de cada vez. O Nome do Parâmetro da Página deve ser uma lista de chaves separada por vírgulas. Essas chaves encontram o link da próxima página na resposta. Por exemplo, "info, next".
    Parâmetro de página e número da página inicial
    Use quando quiser acesso direto a um número de página conhecido. Depois, insira o Variáveis de paginação.
  14. Selecionar Salvar. Se você for até a Preparar ferramenta e selecionar Ensaio, o Minitab Connect exibe os dados importados.
    Observação

    Se nenhum dado aparecer após você selecionar Ensaio, selecione Redefinir configuração.

Quando você salva a importação, Connect cria um fluxo com as configurações que você selecionou. Para mais informações sobre como agendar um fluxo e adicionar mais processos de dados para limpar dados, acesse Visão geral da Fluxo ferramenta.

JSON Lógica de Achatamento

O Connect achata os resultados JSON para representá-los corretamente como uma tabela. Achatamento significa colocar o JSON em uma única estrutura hierárquica para que não haja objetos filhos ou pais. Colunas podem então ser representadas, já que tudo é um par-chave-valor. Objetos aninhados são exibidos por um operador de ponto no nome da coluna.