Apidog Docs
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇧🇷 Português (Brasil)
  • 🇺🇸 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. Módulos de valores dinâmicos
  • Centro de Aprendizado da Apidog
  • Primeiros passos
    • Introdução ao Apidog
    • Conceitos básicos no Apidog
    • Navegando pelo Apidog
    • Início rápido
      • Visão geral
      • Criando um Endpoint
      • Fazendo uma Requisição
      • Adicionando uma assertiva
      • Criação de Cenários de Teste
      • Compartilhamento da 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 do Insomnia
        • Importar do apiDoc
        • Importar arquivo .har
        • Importar WSDL
  • Dados de API mock
    • Visão geral
    • Smart Mock
    • Mock personalizado
    • Sequência de Prioridade do Mock
    • Scripts de Mock
    • Mock na Nuvem
    • Mock do Runner Auto-hospedado
    • Idioma do Mock (Locales)
  • Conta e preferências
    • Configurações da Conta
    • Geração de Token de Acesso OpenAPI
    • Notificação
    • Configurações de idioma
    • Teclas de Atalho
    • Configuração de Proxy de Rede
    • Backup de Dados
    • Atualizando o Apidog
    • Exclusão da conta
    • Recursos Experimentais
  • Enviar requisições
    • Visão geral
    • Depuração de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP ou WebService
    • GraphQL
    • gRPC
    • Use Agentes de Proxy de Requisição para Depuração
    • Criar requisições
      • Histórico de Requisições
      • Conceitos Básicos de Requisições
      • Parâmetros e Corpo
      • Cabeçalhos da Requisição
      • Configurações da Requisição
      • Depurar Requisições
      • Salvando Requisições como Endpoints
      • HTTP/2
    • Autenticação e autorização
      • Visão geral
      • Certificados de CA e de Cliente
      • Tipos de autorização
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Autenticação Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Resposta e cookies
      • Visualização de respostas de API
      • Gerenciamento de Cookies
      • Visão geral
  • Desenvolver e depurar APIs
    • Visão geral
    • Gerando Requisições
    • Envio de Requisições
    • 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
      • Usando variáveis
      • Gerenciamento 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
      • Banco de Dados
      • Tipo de dados
      • Data
      • Finanças
      • Comida
      • Git
      • Hacker
      • Helpers
      • Imagem
      • Internet
      • Localização
      • Lorem
      • Música
      • Número
      • Pessoa
      • Telefone
      • Ciência
      • String
      • Sistema
      • Veículo
      • Palavra
    • Pré e pós-processadores
      • Visão geral
      • Assertiva
      • 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é-processador
        • Scripts de Pós-processamento
        • Scripts Públicos
        • Referência de Scripts do Postman
        • Chamando Outras Linguagens de Programação
        • Usando bibliotecas JS
        • Visualização de Respostas
        • Exemplos de scripts
          • Scripts de assertiva
          • Usando Variáveis
          • Modificando Requisições
          • Outros exemplos
    • Depuração de APIs
      • AI Agent Debugger
      • A2A Debugger
  • Projetar APIs
    • Visão geral
    • Criar um Novo Projeto de API
    • Conceitos Básicos de Endpoint
    • Diretrizes de Design de API
    • Módulo
    • Configurar vários exemplos de corpo da requisição
    • Componentes
    • Campos Comuns
    • Parâmetros Globais
    • Histórico de Alterações do Endpoint
    • Comentários
    • Gerenciamento 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
      • Usar o Security Scheme
      • Esquema de segurança na documentação online
    • Recursos avançados
      • Campos de Endpoint Personalizados
      • Cenários de Teste Associados
      • Status 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 schemas a partir de JSON etc.
      • oneOf, allOf, anyOf
      • Usando Discriminator
  • Branches
    • Visão geral
    • Criando uma Branch de Sprint
    • Testando APIs em uma Branch
    • Projetando APIs em uma branch
    • Mesclando branches de sprint
    • Gerenciando Branches de Sprint
    • AI Branch (Beta)
  • Testes de API
    • Visão geral
    • Cenários de teste
      • Criar um cenário de teste
      • Passar Dados Entre Requisições
      • Condições de Controle 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 Compartilhados
      • Tarefas agendadas
      • Gerenciar o ambiente de execução de APIs de outros projetos
    • Suíte de testes
      • Visão geral
      • Criar Uma Suíte de Testes
      • Orquestrar Suite de Testes
      • Executar Suítes de Teste Localmente
      • Executar Suítes de Teste Via CLI
      • Tarefas agendadas
    • Testar APIs
      • Teste de integração
      • Teste de desempenho
      • Testes de Ponta a Ponta
      • Teste de regressão
      • Teste de Contrato
    • Apidog CLI
      • Visão geral
      • Instalando e executando o Apidog CLI
      • Opções da CLI do Apidog
    • CI/CD
      • Visão geral
      • Integrar com Github Actions
      • Integre com o Gitlab
      • Integrar com o Jenkins
      • Acionar teste por commit do Git
  • Publicar documentação de API
    • Visão geral
    • Tecnologias de API Suportadas
    • Compartilhamento rápido
    • Visualização da documentação da API
    • Documentação em Markdown
    • Publicação de sites de documentação
    • Página de login personalizada
    • Layouts Personalizados
    • CSS, JavaScript e HTML personalizados
    • Domínio Personalizado
    • Recursos de IA
    • Configurações de SEO
    • Configurações avançadas
      • Pesquisa na documentação
      • Proxy CORS
      • Integração com o Google Analytics
      • Configurações da Árvore de Pastas
      • Configurações de Visibilidade
      • Incorporação de valores em URLs de documentação
    • Versões da API
      • Visão geral
      • Criando versões de API
      • Publicação de Versões da API
      • Compartilhamento de Endpoints com Versões da API
  • Recursos de IA
    • Visão geral
    • Habilitando recursos de IA
    • Geração de Casos de Teste
    • Modificando esquemas com IA
    • Verificação de conformidade de endpoint
    • Verificação de Completude da Documentação da API
    • Nomeação de Campos com IA
    • Perguntas frequentes
  • Servidor MCP do Apidog
    • Visão geral
    • Conectar projeto Apidog à IA
    • Conectar documentação publicada à IA
    • Conectar Arquivos OpenAPI à IA
  • Boas práticas
    • Como lidar com assinaturas de API
    • Acessando APIs protegidas por OAuth 2.0
    • Fluxo de Trabalho de Colaboração
    • Gerenciamento do Estado de Autenticação
  • Espaço offline
    • Visão geral
  • Administração
    • Gerenciamento de projetos
      • Gerenciamento de Projetos
      • Configurações de notificação
      • Gerenciamento de membros do projeto
      • Recursos do projeto
        • Conexão com Banco de Dados
        • Conexão Git
    • Gerenciamento de equipes
      • Gerenciando equipes
      • Gerenciando membros da equipe
      • Atividades da Equipe
      • Funções e permissões da equipe
      • Recursos da equipe
        • General Runner
        • Variáveis de Equipe
        • Agente de Proxy de Requisições
      • Colaborações em tempo real
        • Colaboração em Equipe
    • Checklist de integração
      • Conceitos Básicos
      • Guia de Onboarding
    • Gerenciamento da organização
      • Gerenciamento de Organização
      • Funções e permissões da organização
      • Gerenciamento de planos
        • Gerentes de cobrança em organizações
      • Single Sign-On (SSO)
        • Visão geral do SSO
        • Configurando o Microsoft Entra ID
        • Configurando o Okta
        • Configurando SSO para uma organização
        • Gerenciamento de contas de usuário
        • Mapeamento de Grupos para Equipes
      • Provisionamento SCIM
        • Introdução ao provisionamento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos da organização
        • Runner Auto-Hospedado
  • Apidog Europe
    • Apidog Europe
  • Cobrança
    • Visão geral
    • Créditos
    • Atualizando seu plano
    • Métodos de Pagamento Alternativos
    • Gerenciamento de assinaturas
    • Movendo equipes pagas para organizações
  • Complementos
    • Hub de APIs
    • Plugin Apidog Intellij IDEA
    • Extensão do navegador
      • Chrome
      • Microsoft Edge
    • Proxy de requisições
      • Proxy de Requisição na Web
      • Proxy de Requisição em Documentação Compartilhada
      • Proxy de Requisição no Cliente
  • Dados e segurança
    • Armazenamento e Segurança de Dados
    • Privacidade e Segurança dos Dados do Usuário
    • Roteamento de Requisições e Segurança de Dados
  • Referências
    • Abordagem API Design-First
    • Extensões da especificação OpenAPI do Apidog
    • JSONPath
    • XPath
    • Expressões Regulares
    • JSON Schema
    • Formato de Arquivo CSV
    • Instalando o ambiente Java
    • Ambiente de Implantaçã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
  1. Módulos de valores dinâmicos

Localização

Módulo para gerar endereços e localizações.

Visão geral do módulo#

Para um endereço residencial típico de uma localidade, use {{$location.streetAddress}}, {{$location.city}}, {{$location.state}} e {{$location.zipCode}}. A maioria das localidades fornece versões localizadas para um país específico.
Se você precisar de coordenadas de latitude e longitude, use {{$location.latitude}} e {{$location.longitude}}, ou {{$location.nearbyGPSCoordinateLatitude}} para uma latitude/longitude próxima a uma determinada localização.
Para um país aleatório, você pode usar {{$location.country}} ou {{$location.countryCode}}.

buildingNumber#

Gera um número de edifício aleatório.
Retorna: string
Exemplos

cardinalDirection#

Retorna uma direção cardinal aleatória.
Parâmetros
NomeTipoPadrãoDescrição
abbreviatedbooleanfalseSe true, retornará direções abreviadas (N, E etc.). Caso contrário, retornará o nome completo.
Retorna: string
Exemplos

city#

Gera um nome de cidade localizado aleatório.
Retorna: string
Exemplos

country#

Retorna um nome de país aleatório.
Retorna: string
Exemplos

countryCode#

Retorna um nome de país aleatório.
Parâmetros
NomeTipoPadrãoDescrição
variant'alpha-2' |'alpha-3' | 'numeric''alpha-2'O código a ser retornado. Pode ser 'alpha-2' (código de duas letras), 'alpha-3' (código de três letras) ou 'numeric' (código numérico).
Retorna: string
Exemplos

direction#

Retorna uma direção aleatória.
Parâmetros
NomeTipoPadrãoDescrição
abbreviatedbooleanfalseSe true, retornará direções abreviadas (NW, E etc.). Caso contrário, retornará o nome completo.
Retorna: string
Exemplos

latitude#

Gera uma latitude aleatória.
Parâmetros
NomeTipoPadrãoDescrição
maxnumber90O limite superior para a latitude a ser gerada.
minnumber-90O limite inferior para a latitude a ser gerada.
precisionnumber4O número de casas decimais de precisão para a latitude.
Retorna: number
Exemplos

longitude#

Gera uma longitude aleatória.
Parâmetros
NomeTipoPadrãoDescrição
maxnumber90O limite superior para a longitude a ser gerada.
minnumber-90O limite inferior para a longitude a ser gerada.
precisionnumber4O número de casas decimais de precisão para a longitude.
Retorna: number
Exemplos

nearbyGPSCoordinate#

Gera uma coordenada GPS aleatória dentro do raio especificado a partir da coordenada fornecida.
INFO
O método original faker.location.nearbyGPSCoordinate() foi refinado em duas variáveis mais precisas:
{{$location.nearbyGPSCoordinateLatitude}}: gera uma latitude dentro do raio especificado a partir da coordenada fornecida.
{{$location.nearbyGPSCoordinateLongitude}}: gera uma longitude dentro do raio especificado a partir da coordenada fornecida.
Parâmetros
NomeTipoPadrãoDescrição
isMetricbooleanfalseSe true, assume que o raio está em quilômetros. Se false, em milhas.
latitudenumberA latitude original para obter uma nova coordenada próxima.
longitudenumberA longitude original para obter uma nova coordenada próxima.
radiusnumber10A distância máxima da coordenada fornecida até a nova coordenada.
Retorna: [latitude: number, longitude: number]
Exemplos

ordinalDirection#

Retorna uma direção ordinal aleatória (noroeste, sudeste etc.).
Parâmetros
NomeTipoPadrãoDescrição
abbreviatedbooleanfalseSe true, retornará direções abreviadas (NW, SE etc.). Caso contrário, retornará o nome completo.
Retorna: string
Exemplos

secondaryAddress#

Gera um endereço secundário localizado aleatório. Isso se refere a uma localização específica em um determinado endereço, como um número de apartamento ou sala.
Retorna: string
Exemplos

state#

Retorna um estado localizado aleatório ou outra entidade administrativa equivalente de primeiro nível para o país da localidade, como uma província ou região. Geralmente, essas são as subdivisões ISO 3166-2 de um país. Se uma localidade não corresponder a um país específico, o método poderá retornar subdivisões ISO 3166-2 de um ou mais países que usam esse idioma. Por exemplo, a localidade ar inclui subdivisões de países de língua árabe, como Tunísia, Argélia, Síria, Líbano etc. Por motivos de compatibilidade histórica, a localidade padrão en inclui apenas estados dos Estados Unidos (idêntica a en_US). No entanto, você pode usar outras localidades em inglês, como en_IN, en_GB e en_AU, se necessário.
Parâmetros
NomeTipoPadrãoDescrição
abbreviatedbooleanfalseSe true, retornará nomes abreviados de entidades administrativas de primeiro nível. Caso contrário, retornará o nome completo.
Retorna: string
Exemplos

street#

Gera um nome de rua localizado aleatório.
Retorna: string
Exemplos

streetAddress#

Gera um endereço residencial localizado aleatório.
Parâmetros
NomeTipoPadrãoDescrição
useFullAddressbooleanQuando true, gerará um endereço completo. Caso contrário, gerará apenas um endereço residencial.
Retorna: string
Exemplos

timeZone#

Retorna um fuso horário IANA aleatório relevante para esta localidade.
O fuso horário retornado está vinculado à localidade atual.
Retorna: string
Exemplos

zipCode#

Gera um código postal aleatório a partir do formato especificado. Se o formato não for especificado, o formato de código postal da localidade será usado.
Parâmetros
NomeTipoPadrãoDescrição
formatstringWThe optional format used to generate the zip code. This won't be used if the state option is specified.
Retorna: string
Exemplos
Modified at 2026-06-11 10:21:25
Previous
Internet
Next
Lorem
Built with