Apidog Docs
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Envio de requisições
  • Back to home
  • Central de suporte
  • Centro de Suporte da Apidog
  • Importar/exportar
    • Como importar dados de API para o Apidog?
    • Como importar cURL no Apidog?
    • Como migrar ambientes do Postman para o Apidog?
    • Como agrupar automaticamente endpoints na importação de Swagger/OpenAPI?
  • Envio de requisições
    • O Apidog suporta Socket.IO?
    • Porque é que o "+" no valor do parâmetro é descodificado como um espaço?
    • Como enviar um pedido no Apidog?
    • Como enviar um pedido GraphQL no Apidog?
    • Como enviar um pedido gRPC no Apidog?
    • Como enviar um pedido SOAP/WebService no Apidog?
    • Como enviar um pedido WebSocket no Apidog?
    • O Apidog suporta scripts pré-pedido/teste e asserções em APIs WebSocket?
    • Como enviar um pedido SSE no Apidog?
    • Como adicionar cabeçalhos predefinidos ao nível da pasta?
    • O Apidog suporta scripts pré-pedido/de teste e asserções em APIs gRPC?
    • Erro do resolvedor DNS ELANREFUSED.DNS
    • Porque estou a receber um erro "socket hang up" ao enviar um pedido?
    • Correção de erros de requisição
      • Corrigir o erro read ECONNRESET
      • Corrigir o erro ECONNREFUSED
      • Corrigir o erro ETIMEDOUT
      • Corrigir o erro ENOTFOUND: Couldn't resolve host
      • Corrigir ENOTFOUND: getaddrinfo ENOTFOUND www Error
      • Corrigir o erro connect EHOSTUNREACH
  • Projeto de APIs
    • Como utilizo variáveis no caminho?
    • Posso utilizar um componente de resposta como resposta predefinida?
    • Como verificar quem modificou um endpoint?
    • Como posso eliminar pastas de endpoints em massa no Apidog?
    • Como posso adicionar/remover prefixos em massa ao caminho dos endpoints?
    • Como mover o nível de uma propriedade no Editor de Esquemas?
    • Se uma propriedade de string tiver vários valores enumerados e for utilizada em vários locais, como é que este enum pode ser referenciado de forma consistente em todo o lado?
    • Como obter o ID da pasta de recursos do Apidog?
    • Como posso obter o ID da pasta de recursos do Apidog?
    • Como utilizo variáveis num caminho de URL?
    • O que deve fazer se um endpoint, documento ou cenário de teste for eliminado acidentalmente?
    • O Apidog suporta código de pedido para endpoints personalizados?
    • Como agrupar automaticamente endpoints ao importar Swagger/OpenAPI para o Apidog?
    • Como gero dados de array não duplicados em respostas mock?
    • Porque é que a entrada "#" não é suportada no caminho?
  • Depuração de APIs
    • Como é que o Apidog se integra com sistemas de gestão de chaves de terceiros?
    • Porque é que o mesmo pedido funciona corretamente noutras ferramentas (como o Postman), mas não no Apidog?
    • Como obter valores de variáveis a partir da base de dados no Apidog?
    • Como migrar ambientes de outras ferramentas para o Apidog?
    • Como criar asserções utilizando scripts no Apidog?
    • JSONPath só consegue extrair arrays. Como podemos extrair um único elemento dentro deles no Apidog?
    • Como configurar operações de base de dados no Apidog quando diferentes ambientes têm diferentes credenciais de conta da base de dados?
    • Como obter o URL base do serviço num script personalizado?
    • Porque é que o Apidog comunica um erro de excesso do comprimento máximo de string do Node.js quando a resposta da API é demasiado grande?
    • Qual é o limite de tamanho para a impressão na consola? Porque recebo um erro ao imprimir ficheiros grandes?
    • Como resolver erros de ligação à base de dados DB2 no Windows?
    • Porque estou a obter o erro NJS-045 ao ligar-me a uma base de dados Oracle no Apidog?
    • Como gerar valores dinâmicos em scripts personalizados do Apidog?
    • Porque é que o pedido do cliente para o mesmo endpoint é bem-sucedido, mas ocorre um erro ao depurar no lado web: "Não é possível solicitar o endereço"?
    • Porque é que o Apidog comunica um erro quando a resposta é demasiado grande?
    • Como posso utilizar o endpoint de gravação do Apidog?
    • Ao definir uma resposta de endpoint, é permitido que o endpoint não tenha conteúdo de resposta?
    • Como obtenho a baseURL do serviço num script personalizado?
    • Como posso visualizar o pacote original no Apidog?
    • Porque é que vejo o erro "Invalid URI xxx" ao fazer um pedido?
    • Como faço um pedido assíncrono num script do Apidog?
    • Porque vejo a mensagem "Couldn't resolve host" ao enviar um pedido?
    • Qual é o limite de tamanho de impressão na consola? Porque ocorre um erro ao imprimir um ficheiro grande?
    • Como faço para carregar um ficheiro num pedido de endpoint?
    • O que fazer se o Apidog falhar ou os dados da resposta não forem apresentados?
    • URI de Redirecionamento Oficial utilizado pelo Apidog para OAuth2.0
  • Dados de API mock
    • Como simular APIs automaticamente?
    • O que pode fazer o mocking do Apidog?
    • Como fazer mock de dados fixos de API no Apidog?
    • Como simular dados condicionais no Apidog?
    • Como ativar o mock na cloud no Apidog?
    • Como ativar o mock autoalojado no Apidog?
    • O Apidog suporta mocks de APIs WebSocket?
    • Porque é que o browser não devolve conteúdo ao solicitar o endpoint mock?
  • Testes automatizados
    • Porque é que os cenários de teste são executados sem problemas no meu cliente local, mas ocorrem erros ao executá-los na CLI ou no runner do Apidog?
    • Como criar um cenário de teste no Apidog?
    • Como passar dados entre etapas de teste?
    • Porque não consigo referenciar com êxito dados do passo anterior?
    • Como utilizar o ciclo foreach no Apidog?
    • Quais são as diferenças entre sincronizar dados de endpoints/casos de endpoint?
    • Como utilizar dados de teste no Apidog?
    • Como obter dados de teste em scripts no Apidog?
    • Como executar cenários de teste em lote no Apidog?
    • Como agendar tarefas de teste no Apidog?
    • Como executar um teste de desempenho no Apidog?
    • Como pode visualizar os pedidos e as respostas reais nos testes de desempenho?
    • Como posso exportar relatórios de testes de desempenho no Apidog?
    • Como utilizar resultados de consultas à base de dados como parâmetros para pedidos de API em loop?
    • Capturar e Validar Webhooks do Stripe no ApiDog Durante CI/CD
    • Como resolver o erro "Error: unable to verify the first certificate on runner"?
    • Erro "Not Found" no Contentor Docker do General Runner.
    • Como definir o host do servidor para o General Runner na versão Web do Apidog?
    • Porque é que o cenário de teste agendado terminou com 0 pedidos?
    • O que deve fazer se o parâmetro de carregamento de ficheiro não for encontrado no Runner ou na CLI?
    • Como utilizar o Runner para executar um cenário de teste com um passo de carregamento de ficheiro?
    • Como resolvo o erro "Error: unable to verify the first certificate on runner"?
    • Como pode aceder e pesquisar os logs do runner para identificar o problema quando surge um problema com um runner?
    • O que devo fazer se o parâmetro do endpoint for um ficheiro de upload e não puder ser encontrado no Runner ou na CLI?
    • Porque é que os passos de teste não são sincronizados automaticamente quando o caso de uso da API muda?
    • Porque é que a utilização de vários sinais de dólar num documento Markdown faz com que algum conteúdo não seja apresentado corretamente?
    • O Runner autoalojado gera um relatório de teste no servidor após executar uma tarefa?
    • Posso adicionar pré/pós-processadores unificados a pedidos num cenário de teste?
    • Como posso manter valores dinâmicos consistentes durante uma única execução de teste automatizado?
  • Publicar documentação de API
    • Como ocultar todos os logótipos da Apidog em documentos publicados?
    • Quando a especificação da API é atualizada, a documentação da API muda?
    • Como partilhar APIs com colaboradores no Apidog?
    • Como personalizar o domínio das documentações do Apidog?
    • Como criar documentação multiversão no Apidog?
    • Âmbito de partilha para Sites de Documentação Publicados no Apidog
    • Âmbito de partilha da lista Share Doc no Apidog
    • Porque é que a documentação partilhada publicada não mostra o hostname?
    • Como podem os utilizadores da documentação modificar a URL Base em documentação partilhada?
    • Posso duplicar um documento Apidog publicado para usar no meu próprio projeto?
    • Como Partilhar Cabeçalhos (por exemplo, Token) na Documentação Online do Apidog?
    • Porque é que o membro da minha equipa não consegue encontrar a documentação publicada?
    • Como corrijo a expiração de um certificado SSL ou um erro 526 da Cloudflare no meu domínio personalizado?
    • SMTP personalizado configurado com sucesso, mas os utilizadores na lista de permissões não recebem e-mails com OTP
  • Markdown
    • Como utilizar cartões para ligar a várias páginas ou endpoints dentro do Apidog?
    • Porque é que algum conteúdo não é apresentado corretamente ao utilizar vários símbolos $ em documentos Markdown?
    • Como utilizar imagens com fundo transparente no Markdown do Apidog?
    • Como definir a largura das colunas de uma tabela Markdown?
    • Como pode inserir APIs internas, documentos, esquemas de dados ou pastas num documento Markdown?
    • Como posso adicionar uma ligação a um documento ou endpoint dentro de um projeto num componente de cartão do Apidog?
  • Ramos
    • Como aceder ao branch de sprint?
  • Administração
    • Como instalar o cliente Apidog silenciosamente?
    • Porque estou a ver um erro “No Permission” apesar de ter acesso de administrador?
    • Como posso verificar o número da versão do runner?
    • O Apidog suporta Windows 7?
    • Porque é que o Apidog apresenta o erro "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" após a instalação?
    • Alterações de Subscrição e Reembolsos
    • Os pedidos Web funcionam, mas a aplicação apresenta "read ECONNRESET" — Porquê?
    • Porque não consigo abrir o Apidog após uma atualização do sistema Windows?
    • Porque é que o Apidog não abre após uma atualização do sistema Windows
  • Cobrança
    • Posso configurar uma conta de faturação separada para a minha equipa no Apidog?
    • Problemas de Acesso da Equipa e Faturação no Apidog
    • O membro da equipa convidado não consegue aceder ao Apidog.
    • Transferir uma Equipa Paga Pessoal para uma Organização
  • On-premises
    • Gestão de utilizadores e acessos na versão Self-Hosted (Enterprise) do Apidog
  • Web e cliente
    • Transferência e instalação da versão de ambiente de trabalho para Linux
  1. Envio de requisições

Como enviar um pedido gRPC no Apidog?

gRPC é uma framework de Chamada de Procedimento Remoto (RPC) eficiente, rápida e fiável, amplamente utilizada em vários cenários. Na arquitetura de microsserviços, o Apidog facilita uma comunicação eficiente entre serviços. Para cenários que envolvem uma transferência substancial de dados, o Apidog utiliza capacidades de streaming para reduzir a latência da rede e o consumo de largura de banda.
A funcionalidade de depuração da API gRPC encontra-se atualmente na fase de testes Beta. A versão do Apidog deve ser igual ou superior à 2.3.0 para utilizar a funcionalidade de depuração da API gRPC.

Criar um novo projeto gRPC#

Clique no botão "New Project" na página inicial do Apidog e selecione "gRPC Project (Beta)".

Importar Proto#

gRPC segue uma abordagem API-First, o que significa que, antes do desenvolvimento, os serviços, métodos e mensagens devem ser definidos através de ficheiros .proto. Por conseguinte, antes de depurar APIs gRPC com o Apidog, tem de importar o ficheiro .proto que serve como definição da API.

Importação inicial#

Atualmente, existem duas formas de importar ficheiros .proto:
Ficheiro local
URL que aloja o ficheiro .proto
O ficheiro .proto selecionado será importado como um Proto, em que o serviço será importado como um serviço e o rpc será importado como métodos.
Se o ficheiro .proto escolhido depender de outros ficheiros .proto, tem de adicionar manualmente o diretório de dependências.
Os serviços de outros ficheiros .proto dos quais o ficheiro .proto selecionado depende também serão importados para o mesmo Proto se o respetivo package pertencer ao mesmo package do ficheiro .proto selecionado.

Reimportar#

Se o ficheiro .proto importado sofrer alterações, pode ser reimportado no Apidog: clique com o botão direito do rato em Proto e, em seguida, clique no botão "Reimport".

Métodos de invocação#

Ao definir métodos gRPC com ficheiros .proto, o Apidog suporta quatro tipos:
Unary: chamada unidirecional
Server Streaming: streaming do lado do servidor
Client Streaming: streaming do lado do cliente
Bidirectional Streaming: streaming bidirecional
O Apidog suporta os quatro tipos de método.

Chamada unary#

As chamadas unary são semelhantes a pedidos HTTP. Introduza o URL na barra de endereço, insira o conteúdo da mensagem em formato JSON no separador Message, clique no botão "Invoke" e a chamada unary será iniciada.
Além disso, pode preencher manualmente as informações de Metadata e Auth para satisfazer cenários de autenticação ou outros cenários complexos.

Chamada de streaming#

As chamadas de streaming são semelhantes a ligações WebSocket. Depois de iniciar a chamada, pode escrever e enviar mensagens no separador Message. O streaming do servidor, o streaming do cliente e o streaming bidirecional enquadram-se nos tipos de chamadas de streaming.
O Apidog disponibiliza uma vista de linha cronológica que apresenta de forma centralizada o estado da chamada, as mensagens enviadas e as mensagens recebidas por ordem cronológica. Ao clicar numa mensagem, pode ver facilmente os detalhes da mensagem.

Utilização avançada#

Gerar valores dinâmicos automaticamente#

O Apidog consegue reconhecer o conteúdo dos ficheiros .proto, permitindo-lhe clicar no botão "Auto-generate" para gerar o corpo da mensagem. Para dados dinâmicos mais flexíveis, pode configurar e gerar expressões utilizando a funcionalidade "Dynamic Values".
Consulte "Dynamic Values" para obter instruções mais detalhadas.

Utilizar variáveis#

Pode utilizar variáveis do Apidog em mensagens gRPC e Metadata. Consulte a documentação "Environment Variable Types" para obter instruções detalhadas.

Ativar TLS#

As APIs gRPC suportam o estabelecimento de ligações seguras através de TLS.
Com o Apidog, pode clicar no seletor de protocolo à frente do URL para alternar rapidamente o estado do TLS.
Além disso, o Apidog é compatível com a utilização de grpcs:// no URL para ativar TLS para a ligação. Inversamente, grpc:// indica que TLS não está ativado.

Gerir endereços de servidor e ambientes#

Clique no ícone de mais no lado direito da barra de endereço do URL para adicionar o endereço de servidor atualmente utilizado a um ambiente.
Em seguida, selecione o ambiente e o endereço do servidor no canto superior direito e escolha "Follow Default" na barra de endereço do URL para utilizar um endereço de servidor unificado para depurar todos os métodos.

Ver ficheiros Proto e parâmetros da API#

Ver o conteúdo do ficheiro Proto#

No Apidog, ao clicar no Proto na árvore de diretórios à esquerda, pode ver o conteúdo bruto do ficheiro .proto.

Ver parâmetros de pedido e resposta#

gRPC utiliza ProtoBuf como formato de serialização, o que significa que cada mensagem é transmitida em formato ProtoBuf ao enviar ou receber mensagens. Ao contrário de outros formatos de serialização baseados em texto (JSON, XML), ProtoBuf é um formato binário não adequado para escrita e leitura humanas. Por conseguinte, ao chamar APIs gRPC no Apidog, todas as mensagens são escritas e apresentadas em formato JSON.
Pode ver os parâmetros de pedido e resposta representados em formato JSON na página de informações da API.
ProtoBuf e JSON têm uma relação de mapeamento para tipos de dados, conforme apresentado na tabela abaixo:
ProtoBuf 3JSONExemplo JSON
messageobject{"fooBar": v, "g": null, …}
enumstring"FOO_BAR"
map<K,V>object{"k": v, …}
repeated Varray[v, …]
boolbooleantrue, false
stringstring"Hello World!"
bytesbase64 string"YWJjMTIzIT8kKiYoKSctPUB+"
int32, fixed32, uint32number1, -10, 0
int64, fixed64, uint64string"1", "-10"
float, doublenumber1.1, -10.0, 0, "NaN", "Infinity"

Guardar informações de depuração#

Depois de concluir a depuração, clique no botão "Save" para guardar o URL do servidor, mensagens, Metadata, etc., no método atual, para que outros membros da equipa possam depurar.
Modified at 2026-06-09 08:54:45
Previous
Como enviar um pedido GraphQL no Apidog?
Next
Como enviar um pedido SOAP/WebService no Apidog?
Built with