Categoria REST

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 16 min. de leitura

    • Verifique a funcionalidade das chamadas REST.

    Enviar Solicitação REST – de entrada – Explorador de REST API

    Esta etapa de teste começa com o Explorador da REST API. Use o Explorador da REST API para criar e especificar o método HTTP, o caminho, os parâmetros de consulta, cabeçalhos de solicitação e o corpo de uma solicitação REST e, em seguida, envie a solicitação REST para a instância atual.

    Quando você tiver testado a solicitação, o. Criar etapa de teste automatizado o botão é exibido. Clique em Criar etapa de teste automatizado para criar a etapa de teste. Este botão não aparece até que a solicitação seja enviada. Você não pode criar uma etapa de teste quando a carga da solicitação é maior que a propriedade Tamanho máximo da carga da solicitação.

    Esta etapa de teste cria o mesmo registro de teste que o. Enviar solicitação REST - Entrada etapa de teste. Após a criação da etapa de teste, você não poderá voltar e usar o Explorador da REST API para atualizar o teste. Todas as mudanças devem ser feitas no Enviar solicitação REST - Entrada formulário de etapa de teste.

    Nenhuma validação de resposta HTTP é realizada como parte desta etapa. A etapa falhará se o tamanho da carga de resposta for muito grande, os parâmetros da solicitação forem inválidos ou a solicitação não puder ser enviada. Use as etapas de declaração para validar a resposta.

    Você não pode usar essa etapa para enviar uma solicitação para outra instância ou terceiros/endereço remoto.

    Essas entradas são para o Explorador da REST API. Os campos exibidos dependem da API selecionada. Para obter mais informações sobre como usar APIs REST em sua instância, consulte REST APIs .

    Tabela 1. Entradas
    Campo Descrição
    Namespace Namespace da solicitação. Selecione na lista.
    Nome da API API a ser usada. Selecione na lista.
    Versão da API Versão da API a ser usada. Selecione a versão disponível na sua instância na lista.
    Parâmetros de caminho A parte do caminho após o nome da API. Os parâmetros de caminho são geralmente pares nome-valor em que os valores permitidos estão em uma lista.
    Parâmetros de consulta Pares nome-valor de parâmetros de consulta adicionados ao URI após o caminho.

    O Explorador da REST API codifica o URI, portanto, não é necessário codificar parâmetros e valores de consulta.
    Cabeçalhos da solicitação Pares nome-valor contidos no cabeçalho da solicitação. O cabeçalho de autenticação está definido como Enviar como eu para usar as credenciais do usuário atual. Para usar a etapa de teste na produção, talvez seja necessário mudar Tipo de autenticação no REST - Entrada etapa de teste.

    Não codifique o nome ou o valor.
    Corpo da Solicitação O conteúdo da solicitação. Algumas solicitações não têm um corpo.

    Enviar solicitação REST – de entrada

    Crie uma etapa de teste para enviar uma solicitação REST para a instância atual. Especifique o método HTTP, o caminho, os parâmetros de consulta, os cabeçalhos da solicitação e o corpo de uma solicitação REST.

    Nenhuma validação de resposta HTTP é realizada como parte desta etapa. A etapa falhará se o tamanho da carga de resposta for muito grande, os parâmetros da solicitação forem inválidos ou a solicitação não puder ser enviada. Use as etapas de declaração para validar a resposta.

    Você não pode usar essa etapa para enviar uma solicitação para outra instância ou terceiros/endereço remoto.

    Para obter mais informações sobre como usar APIs REST, consulte REST APIs .

    Tabela 2. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Tipo de autenticação

    O tipo de autenticação a ser usado. Para APIs públicas, selecione Nenhum .

    Para configurar a autenticação básica ou mútua, os usuários precisam da função atf_ws_designer. Para obter mais informações, consulte Funções Automated Test Framework.
    Autenticação básica

    O perfil de autenticação básica a ser usado ao fazer o teste. Você deve criar ou selecionar um perfil de autenticação básico para atribuir às etapas de teste para evitar problemas de autenticação ao executar o teste. Para obter mais informações, consulte Crie um perfil de autenticação básico usando a Estrutura de testes automatizados.

    Autenticação mútua

    Um certificado X.509 para autenticação mútua. Você deve criar ou selecionar um certificado de cliente para atribuir às etapas de teste para evitar problemas de autenticação ao executar o teste. Para obter mais informações, consulte Set up Certificate-based authentication.
    Método O método HTTP a ser usado:
    • OBTER
    • POST
    • PUT
    • EXCLUIR
    • PATCH
    Caminho O caminho a ser usado. Este campo aceita somente a parte do URI após o nome da instância. Se você usar https://<instance name> , você recebe um erro.
    Parâmetros de consulta Nomes e valores de parâmetros de consulta. Não codifique os nomes ou valores dos parâmetros.
    Cabeçalhos Valores e nomes de cabeçalho. Não codifique os nomes ou valores do cabeçalho.
    Corpo O corpo da solicitação.

    Declarar Código de Status

    Declare que o código de status da resposta HTTP tem o relacionamento especificado com o valor especificado. Você especifica um valor numérico do código de status e do relacionamento.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 3. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Operação Comparação a ser realizada entre valores:
    • é
    • não é
    • menor que
    • maior que
    • ou é
    • maior que ou é
    Código de status Código de status a ser testado em relação ao código de resposta.

    Declarar Nome do Código de Status

    Declare que o nome do código de status da resposta HTTP tem o relacionamento especificado com o valor especificado. Você especifica um valor do nome do código de status e o relacionamento.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 4. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Operação Comparação a ser realizada entre valores:
    • contém
    • não contém
    • é
    • não é
    Nome do código de status Nome do código de status a ser testado.

    Declarar tempo de resposta

    Declare que o tempo de resposta HTTP tem o relacionamento especificado com o valor especificado. Você especifica um valor do tempo de resposta e do relacionamento.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 5. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Operação Comparação a ser realizada entre Tempo de resposta tempo de resposta inserido e real:
    • menor que
    • maior que
    Tempo de resposta (ms) Tempo em milissegundos a ser comparado com o tempo de resposta real.

    Declarar Cabeçalho de Resposta

    Declare que o cabeçalho de resposta HTTP existe ou o cabeçalho tem o relacionamento especificado com o valor especificado.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 6. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Cabeçalho Nome do cabeçalho.
    Operação Comparação a ser realizada entre valores:
    • contém
    • não contém
    • é
    • não é
    • não está vazio
    Valor Valor do elemento a ser usado no teste. Não mostrado se Operação é não está vazio .

    Declarar que a carga JSON de resposta é válida

    Declare que a carga de resposta está no formato JSON válido.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 7. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.

    Declarar que a carga XML de resposta está bem formada

    Declare que a carga de resposta é XML bem formado.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 8. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.

    Declarar o elemento de carga XML

    Declare que o elemento de carga de resposta XML existe ou tem o relacionamento especificado com o valor especificado.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 9. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Caminho de elemento Caminho XML para o elemento a ser avaliado. Por exemplo, /result/short_description para
    {
  "result": {
    "number": "INC0020001",
    "short_description": "test"
  }
}
    Operação Comparação a ser realizada entre valores:
    • contém
    • não contém
    • é
    • não é
    • não está vazio
    Valor Valor do elemento a ser usado no teste. Não mostrado se Operação é não está vazio .

    Declarar Elemento de Carga de Resposta JSON

    Declare que o elemento de carga de resposta JSON existe ou tem o relacionamento especificado com o valor especificado.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Tabela 10. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Caminho de elemento Caminho SNC para o elemento a ser avaliado. Por exemplo, /result/short_description para
    {
  "result": {
    "number": "INC0020001",
    "short_description": "test"
  }
}
    Consulte Importando arquivos JSON para obter mais informações.
    Operação Comparação a ser realizada entre valores:
    • contém
    • não contém
    • é
    • não é
    • não está vazio
    Valor Valor do elemento a ser usado no teste. Não mostrado se Operação é não está vazio .

    Declarar Carga de Resposta

    Declare que a carga de resposta HTTP tem o relacionamento especificado com o valor especificado. Você especifica o valor e o relacionamento.

    As etapas de declaração devem seguir imediatamente A. Enviar solicitação REST - Entrada etapa. Você pode ter várias etapas de declaração REST após A. Enviar solicitação REST - Entrada , mas as etapas de declaração não podem ser separadas de Enviar solicitação REST - Entrada passo a passo de outras categorias de teste.

    Nota:
    A carga inteira é usada para procurar uma correspondência. Uma carga grande pode afetar o desempenho.
    Tabela 11. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.
    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Operação Comparação a ser realizada entre valores:
    • contém
    • não contém
    • é
    • não é
    • não está vazio
    Corpo da resposta O valor do corpo da resposta a ser usado no teste.

    Deve conter o nome e o valor a serem comparados conforme aparecem na carga de resposta. Não deve conter chaves.

    Não mostrado se Operação é não está vazio .
    Para verificar a descrição resumida na carga de resposta
    {"result":{"number":"INC0010040","short_description":"Test ATF Incident"}}
    . Corpo da resposta deve conter
    "short_description":"Test ATF Incident"
    Esses formatos estão incorretos e a etapa falha.
    • "Short_description":"Testar incidente ATF"
    • "Short_description":"Testar incidente ATF""
    • Short_description: Testar incidente ATF
    • Short_description:"Testar incidente ATF"