Apidog Docs
🇵🇹 Português
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português
🇵🇹 Português
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português
🇵🇹 Português
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Publicar documentação de API
  • Centro de Aprendizagem da Apidog
  • Primeiros passos
    • Introdução ao Apidog
    • Conceitos Básicos no Apidog
    • Navegar no Apidog
    • Início rápido
      • Visão geral
      • Criar um Endpoint
      • Fazer um Pedido
      • Adicionar uma asserção
      • Criar Cenários de Teste
      • Partilhar Documentação da API
      • Explore Mais
    • Migração para o Apidog
      • Visão geral
      • Importação Manual
      • Importação Agendada (Vincular Fontes de Dados)
      • Opções de Importação
      • Exportar Dados
      • Importar de
        • Importar do Postman
        • Importar especificação OpenAPI
        • Importar cURL
        • Importar Markdowns
        • Importar a partir do Insomnia
        • Importar a partir de apiDoc
        • Importar Ficheiro .har
        • Importar WSDL
  • Apidog Europe
    • Apidog Europe
  • Dados de API mock
    • Visão geral
    • Smart Mock
    • Mock personalizado
    • Sequência de Prioridade do Mock
    • Scripts de Mock
    • Mock na Cloud
    • Mock do Runner Autoalojado
    • Idioma de Mock (Localidades)
  • Conta e preferências
    • Definições da Conta
    • Gerar um Token de Acesso OpenAPI
    • Notificações
    • Definições de Idioma
    • Teclas de Atalho
    • Configuração de Proxy de Rede
    • Cópia de Segurança dos Dados
    • Atualizar o Apidog
    • Eliminar Conta
    • Funcionalidades Experimentais
  • Enviar requisições
    • Visão geral
    • Depuração de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP ou WebService
    • GraphQL
    • gRPC
    • Utilizar Agentes de Proxy de Pedido para Depuração
    • Criar requisições
      • Histórico de Pedidos
      • Noções Básicas de Pedidos
      • Parâmetros e Corpo
      • Cabeçalhos do Pedido
      • Definições do Pedido
      • Depurar Pedidos
      • Guardar Pedidos como Endpoints
      • HTTP/2
    • Autenticação e autorização
      • Visão geral
      • Certificados CA e de Cliente
      • Tipos de autorização
      • Autenticação Digest
      • OAuth 1.0
      • OAuth 2.0
      • Autenticação Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Resposta e cookies
      • Visualizar Respostas de API
      • Gerir Cookies
      • Visão geral
  • Desenvolver e depurar APIs
    • Visão geral
    • Gerar Pedidos
    • Enviar Pedidos
    • Casos de Depuração
    • Casos de Teste
    • Valores Dinâmicos
    • Validação de Respostas
    • Design-First vs Request-First
    • Geração de Código
    • Ambientes e variáveis
      • Visão geral
      • Utilizar Variáveis
      • Gestão de Ambientes
    • Segredos do cofre
      • Visão geral
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Módulos de valores dinâmicos
      • Airline
      • Animal
      • Cor
      • Comércio
      • Empresa
      • Base de Dados
      • Tipo de dados
      • Data
      • Finanças
      • Alimentação
      • Git
      • Hacker
      • Helpers
      • Imagem
      • Internet
      • Localização
      • Lorem
      • Música
      • Número
      • Pessoa
      • Telefone
      • Ciência
      • String
      • Sistema
      • Veículo
      • Word
    • Pré e pós-processadores
      • Visão geral
      • Asserção
      • Extrair variável
      • Espera
      • Segurança
      • Operações de banco de dados
        • Visão geral
        • MySQL
        • MongoDB
        • Redis
        • Cliente Oracle
      • Uso de scripts
        • Visão geral
        • Scripts de Pré-processamento
        • Scripts de pós-processamento
        • Scripts Públicos
        • Referência de Scripts do Postman
        • Chamar Outras Linguagens de Programação
        • Utilizar Bibliotecas JS
        • Visualizar Respostas
        • Exemplos de scripts
          • Scripts de Asserção
          • Utilização de Variáveis
          • Modificar Pedidos
          • Outros exemplos
    • Depuração de APIs
      • Depurador de Agentes de IA
      • Depurador A2A
  • Projetar APIs
    • Visão geral
    • Criar um Novo Projeto de API
    • Noções Básicas de Endpoints
    • Diretrizes de Design de API
    • Módulo
    • Configurar vários exemplos de corpo do pedido
    • Componentes
    • Campos Comuns
    • Parâmetros Globais
    • Histórico de Alterações do Endpoint
    • Comentários
    • Gestão de Endpoints em Lote
    • API de Protocolo Personalizado
    • Modo Spec-first (Beta)
    • Esquemas de segurança
      • Visão geral
      • Criar um Esquema de Segurança
      • Utilizar o Esquema de Segurança
      • Esquema de Segurança na Documentação Online
    • Recursos avançados
      • Campos de Endpoint Personalizados
      • Cenários de Teste Associados
      • Estado do endpoint
      • Aparência das listas de parâmetros
      • Identificação Única de Endpoint
    • Schemas
      • Visão geral
      • Criar um Novo Schema
      • Criar um Schema
      • Gerar esquemas a partir de JSON, etc.
      • oneOf, allOf, anyOf
      • Utilizar Discriminator
  • Testes de API
    • Visão geral
    • Cenários de teste
      • Criar um Cenário de Teste
      • Passar Dados Entre Pedidos
      • Condições de Controlo de Fluxo
      • Sincronizar Dados de Endpoints e Casos de Endpoint
      • Importar Endpoints e Casos de Endpoint de Outros Projetos
      • Exportar Cenários de Teste
    • Relatórios de teste
      • Relatórios de Teste
    • Executar cenários de teste
      • Executar um cenário de teste
      • Executar cenários de teste em lote
      • Testes Orientados por Dados
      • Dados de Teste Partilhados
      • Tarefas agendadas
      • Gerir o ambiente de runtime de APIs de outros projetos
    • Suíte de testes
      • Visão geral
      • Criar Uma Suite de Testes
      • Orquestrar Conjunto de Testes
      • Executar Conjuntos de Testes Localmente
      • Executar conjuntos de testes via CLI
      • Tarefas agendadas
    • Testar APIs
      • Testes de Integração
      • Testes de desempenho
      • Testes de Ponta a Ponta
      • Teste de regressão
      • Testes de Contrato
    • Apidog CLI
      • Visão geral
      • Instalar e Executar o Apidog CLI
      • Opções da CLI do Apidog
    • CI/CD
      • Visão geral
      • Integrar com o Github Actions
      • Integrar com o Gitlab
      • Integrar com Jenkins
      • Acionar Teste por Commit Git
  • Publicar documentação de API
    • Visão geral
    • Tecnologias de API Suportadas
    • Partilha Rápida
    • Visualizar a Documentação da API
    • Documentação Markdown
    • Publicar Sites de Documentação
    • Página de Início de Sessão Personalizada
    • Layouts personalizados
    • CSS, JavaScript, HTML personalizados
    • Domínio Personalizado
    • Funcionalidades de IA
    • Definições de SEO
    • Configurações avançadas
      • Pesquisa na Documentação
      • Proxy CORS
      • Integrar o Google Analytics
      • Definições da Árvore de Pastas
      • Definições de Visibilidade
      • Incorporar Valores em URLs de Documentação
    • Versões da API
      • Visão geral
      • Criar Versões de API
      • Publicar versões de API
      • Partilhar Endpoints com Versões da API
  • Branches
    • Visão geral
    • Criar uma Branch de Sprint
    • Testar APIs numa Branch
    • Conceber APIs numa Ramificação
    • Mesclar Branches de Sprint
    • Gerir Branches de Sprint
    • AI Branch (Beta)
  • Recursos de IA
    • Visão geral
    • Ativar Funcionalidades de IA
    • Gerar Casos de Teste
    • Modificar esquemas com IA
    • Verificação de Conformidade do Endpoint
    • Verificação da Completude da Documentação da API
    • Nomeação de Campos com IA
    • Perguntas frequentes
  • Servidor MCP do Apidog
    • Visão geral
    • Ligar o Projeto Apidog à IA
    • Ligar Documentação Publicada à IA
    • Ligar Ficheiros OpenAPI à IA
  • Boas práticas
    • Tratamento de Assinaturas de API
    • Aceder a APIs Protegidas por OAuth 2.0
    • Fluxo de trabalho de colaboração
    • Gestão do Estado de Autenticação
  • Espaço offline
    • Visão geral
  • Administração
    • Gerenciamento de projetos
      • Gerir Projetos
      • Definições de Notificação
      • Gerir Membros do Projeto
      • Recursos do projeto
        • Ligação à Base de Dados
        • Ligação Git
    • Gerenciamento de equipes
      • Gerir Equipas
      • Gerir Membros da Equipa
      • Atividades da Equipa
      • Funções e permissões da equipa
      • Recursos da equipe
        • General Runner
        • Variáveis de Equipa
        • Agente Proxy de Pedidos
      • Colaborações em tempo real
        • Colaboração em Equipa
    • Checklist de integração
      • Conceitos Básicos
      • Guia de Integração Inicial
    • Gerenciamento da organização
      • Gerir a Organização
      • Funções e Permissões da Organização
      • Gerenciamento de planos
        • Gestores de Faturação em Organizações
      • Single Sign-On (SSO)
        • Visão Geral do SSO
        • Configurar o Microsoft Entra ID
        • Configurar o Okta
        • Configurar SSO para uma organização
        • Gerir Contas de Utilizador
        • Mapear Grupos para Equipas
      • Provisionamento SCIM
        • Introdução ao Provisionamento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos da organização
        • Self-Hosted Runner
  • Cobrança
    • Visão geral
    • Créditos
    • Atualizar o seu plano
    • Métodos de Pagamento Alternativos
    • Gestão de Subscrições
    • Mover Equipas Pagas para Organizações
  • Complementos
    • API Hub
    • Plugin Apidog Intellij IDEA
    • Extensão do navegador
      • Chrome
      • Microsoft Edge
    • Proxy de requisições
      • Proxy de pedidos na Web
      • Proxy de Pedidos em Documentação Partilhada
      • Proxy de Pedido no Cliente
  • Dados e segurança
    • Armazenamento e Segurança de Dados
    • Privacidade e Segurança dos Dados do Utilizador
    • Encaminhamento de Pedidos e Segurança dos Dados
  • Referências
    • Abordagem API Design-First
    • Extensões da Especificação OpenAPI do Apidog
    • JSONPath
    • XPath
    • Expressões Regulares
    • JSON Schema
    • Formato de ficheiro CSV
    • Instalar o Ambiente Java
    • Ambiente de Implementação do Runner
    • Sintaxe Markdown do Apidog
    • Extensões Swagger do Apidog
      • Visão geral
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Extensões JSON Schema do Apidog
      • Visão geral
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Central de suporte
    • Apidog Support Center
    • 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?
    • Branches
      • 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. Publicar documentação de API

CSS, JavaScript, HTML personalizados

Ao publicar a sua documentação de API, pode adicionar HTML, CSS e JavaScript globais personalizados para personalizar os estilos das páginas e expandir a funcionalidade.
Esta funcionalidade é útil para:
Incorporar serviços de terceiros (por exemplo, chatbots, assistentes de IA)
Modificar estilos predefinidos (por exemplo, tipo de letra, cor, fundo)
Adicionar elementos interativos (por exemplo, botões, popups, feedback rápido)
Ao utilizar esta funcionalidade de forma criteriosa, a sua documentação pode refletir melhor a identidade da sua marca e melhorar a experiência do utilizador.

CSS#

Com CSS personalizado, pode alterar tipos de letra, ocultar elementos, ajustar margens, alterar cores e muito mais.
Uma vez que a estrutura da documentação poderá mudar em atualizações futuras, recomendamos que siga estes dois princípios para garantir que os seus estilos continuam eficazes:
1.
Utilize variáveis CSS reservadas
2.
Utilize nomes de classes CSS reservados

Utilizar variáveis CSS reservadas#

O Apidog disponibiliza um conjunto de variáveis CSS com o prefixo --g- para controlar estilos básicos da página, como tipo de letra, cor e fundo. Estas variáveis adaptam-se bem aos modos claro e escuro, tornando os seus estilos mais estáveis e fáceis de manter.
Referência de variáveis comuns
Exemplo: Alterar a cor principal do texto

Utilizar nomes de classes CSS reservados#

Para direcionar áreas específicas para estilização, utilize os nomes de classes reservados do Apidog com o prefixo .g-, que são relativamente estáveis e menos propensos a deixar de funcionar devido a alterações no DOM.
Referência de classes CSS comuns
Exemplo: Ocultar a barra lateral esquerda

Inspecionar a estrutura da página e os nomes das classes#

Além das variáveis CSS reservadas e dos nomes de classes mencionados acima, também pode utilizar as ferramentas de programador do navegador para encontrar o nome da classe correspondente ao elemento da página que pretende modificar e, em seguida, escrever CSS para ajustar o estilo.
Recomenda-se que utilize primeiro nomes de classes que começam por .g-. Estes são reservados pela plataforma, têm uma estrutura relativamente estável e são menos propensos a falhar. Para outros nomes de classes estruturais, utilize-os com cautela para evitar falhas de estilo após atualizações do produto.
Pode abrir o site de documentação publicado no navegador e utilizar as ferramentas de programador (modo de programador/consola) para ver a estrutura da página e os nomes das classes de estilo:
Mac: Command + Option + Ioufn + F12
Windows: Ctrl + Shift + Ioufn + F12ouF12
Depois de abrir, clique no "Seletor de elementos" (o ícone do rato) e, em seguida, clique em qualquer área da página para ver as etiquetas HTML e os nomes de classes correspondentes a essa área.
Também pode utilizar a função de pesquisa (Cmd/Ctrl + F) para localizar um nome de classe.
image.png

JavaScript#

O JavaScript personalizado é utilizado para incorporar serviços de terceiros, como assistentes de IA ou widgets de suporte. Nota: o campo de JavaScript personalizado do Apidog não suporta etiquetas <script> ou <style>. Deve convertê-las em JavaScript puro. Por exemplo:
❌ Original (não suportado)
✅ Convertido para JavaScript puro
Se pretender incorporar um script ou estilo de terceiros, mas não tiver a certeza de como o reescrever em formato JS puro, pode copiar o prompt abaixo e colá-lo numa ferramenta de IA (como o Claude) para permitir que a IA o ajude a convertê-lo automaticamente:
I'm using Apidog's "Custom JavaScript" feature, which only allows pure JavaScript (no <script> or <style> tags).

Please convert the following code to pure JavaScript. Here are the requirements:
1. Rewrite the <script> tag to document.createElement('script') dynamic creation method;
2. Inject the <style> content into the newly created style tag and insert the head;
3. Please use standard methods (such as createElement, appendChild) for all DOM operations, and do not use document.write;
4. If the original code uses `window.addEventListener('DOMContentLoaded', ...)` or `window.addEventListener('load', ...)` only to wait for the page before running code, remove the event listener and run the code directly. Apidog executes custom JavaScript after the documentation page has been rendered, so the browser's `load` event may already have passed by that time; code registered inside a `load` listener may not be executed;
5. The final generated JavaScript should be able to run directly in the browser without any explanation.

Original code:
---
(paste your code here)
---
Por motivos de segurança, o JavaScript personalizado só funciona ao aceder à documentação através de domínio personalizado.
Se aceder através do endereço de documentação predefinido fornecido pelo Apidog (por exemplo, começando por https://xxx.apidog.io/), o JS personalizado não será carregado nem executado.
Certifique-se de que o código é fiável para evitar afetar o carregamento normal ou danificar a estrutura da página.
O JavaScript personalizado é executado depois de a página de documentação ter sido renderizada. Como o evento load do navegador pode já ter ocorrido nesse momento, o código colocado dentro de window.addEventListener('load', ...) poderá não ser executado. Na maioria dos casos, execute o seu código diretamente:

Exemplo: Caixa expansível/recolhível#

Clique no botão abaixo para expandir/recolher a caixa de diálogo do iframe
Script para "Clicar no botão para expandir/recolher a caixa de diálogo do iframe"
Como utilizar:
1
Cole o código na área "Custom JavaScript" do Apidog.
2
Visite os sites de documentação através do seu domínio personalizado.
3
É apresentado um botão no canto inferior direito; clique para abrir o iframe de chat.
4
Substitua iframe.src pelo seu serviço de IA, por exemplo:
CSS e JavaScript personalizados

Exemplo: Incorporar o widget Chatbase#

Script para "Incorporar o widget de chat Chatbase"
Como utilizar:
1
Crie uma aplicação Chatbase, obtenha o código de incorporação e converta-o para JS puro utilizando o prompt acima.
image.png
Cole o código convertido na secção Custom JS do Apidog.
2
Visite os sites de documentação através do seu domínio personalizado.
3
Será apresentado um botão no canto inferior direito. Clique nele para abrir uma janela de diálogo.
CSS e JavaScript personalizados

HTML#

A funcionalidade HTML está atualmente em desenvolvimento. Fique atento ao seu lançamento.

Perguntas frequentes#

O JS personalizado não funciona?
Certifique-se de que está a visitar a documentação através de um domínio personalizado. O JavaScript personalizado só é executado quando utiliza um domínio personalizado associado.
Devo utilizar 'load' ou 'DOMContentLoaded' em JavaScript personalizado?
Modified at 2026-06-09 08:54:45
Previous
Layouts personalizados
Next
Domínio Personalizado
Built with