Estágio de descanso: Guia Estágio (DataStage®)

Especifique os detalhes de suas chamadas API REST na guia Estágio.

Especifique o tipo de solicitação a ser feita e o endereço URL. Se você selecionar Use expression (Usar expressão ), poderá especificar uma expressão a ser avaliada e a última instrução retornará o valor real da cadeia de caracteres URL.

Autenticação

Use uma chave de API, um nome de usuário e uma senha básicos ou um token de acesso conforme requerido pelo provedor de API.

Solicitação

Parâmetros de consulta

Especifique os parâmetros de consulta para a solicitação HTTP. Os parâmetros de consulta são pares chave e valor. É possível configurar valores constantes ou usar expressões para configurar valores dinâmicos..

Cabeçalho customizados

Especifique os cabeçalhos para a solicitação HTTP. Cabeçalhos são pares de chave e valor. É possível configurar valores constantes ou usar expressões para configurar valores dinâmicos..

Cookies customizados

Um cookie HTTP é um token ou pacote de informações de status que o agente HTTP e o servidor de destino podem trocar para manter uma sessão. As informações de estado consistem em pares chave-valor para atributos como versão, domínio, um caminho que especifica o subconjunto de URLs no servidor de origem ao qual o cookie se aplica e o tempo máximo para o qual o cookie é válido.

Para configurar um valor constante para o cookie, especifique o valor no campo Valor padrão. Para configurar um valor dinâmico, especifique uma expressão no campo Derivação

Corpo

Defina o formato para o corpo da solicitação Se você selecionar form-data ou x-www-form-urlencoded, o estágio REST avaliará a expressão definida em Derivação e se o resultado for nulo usará o valor em Valor padrão.

Se você selecionar Raw ou Binary, escolha um tipo de conteúdo e charset. Se Auto for selecionado, o tipo de conteúdo será detectado automaticamente, mas a precisão não será garantida. Especifique uma expressão sob o texto ou dados para usar uma coluna de entrada

Resposta

Defina se o corpo de resposta deve ser salvo como texto ou em um arquivo

Se você selecionar Text , o corpo de resposta será a saída nas variáveis RESPONSE_BODY e RESPONSE_BODIES com seus dados originais ou objeto desertado quando o tipo de conteúdo do corpo de resposta for JSON A opção Text requer um link de saída e deve-se especificar uma derivação para cada coluna de saída

Se você selecionar File, poderá fornecer um caminho de arquivo como uma cadeia para um valor constante ou como uma expressão para um valor dinâmico. O corpo de resposta é gravado para o arquivo e o caminho do arquivo é salvo nas variáveis RESPONSE_BODY e RESPONSE_BODY

Configurações

Especifique as configurações de segurança, o tempo limite e o comportamento de nova tentativa e configure os servidores proxy

Controle

Para APIs que suportam paginação, o Estágio REST permite fácil gerenciamento de dados paginados. É possível configurar o estágio para manipular respostas paginadas, assegurando a recuperação completa de dados Especifique um URL dinâmico que muda a cada iteração. O Expression Builder fornece três modelos URL para um fluxo de paginação típico.

Variáveis

Use variáveis para conter valores que podem ser usados em expressões, scripts e outras partes do fluxo de trabalho da API RESTful. As variáveis podem ter expressões de derivação que incorporam parâmetros, colunas e outras variáveis Várias variáveis integradas são fornecidas para armazenar informações de resposta e manter o controle de iterações. Várias funções integradas são fornecidas para ajudar com a formatação.