Dados de códigos em JSON

Identifique números, códigos de chamada e países com confiança.

A API phonecode.app fornece dados estruturados de códigos locais e internacionais, números de serviço e emergência e conversão de números locais para o formato internacional. Desenvolvida para lojas, sistemas CRM, ferramentas de suporte, formulários de potenciais clientes e qualidade interna de dados.

Criar chave Início rápido

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

28.608 Registros

5.200 Redes locais alemãs

206 países e territórios

76 Faixas de serviço e emergência

382 Faixas móveis

Início rápido

Sua primeira consulta em minutos.

Verificar conta

Cadastre uma conta de cliente e confirme seu endereço de e-mail.

Criar chave

Crie uma chave API. Ela é exibida em texto simples apenas uma vez.

Obter JSON

Envie a chave apenas como Bearer Token no cabeçalho Authorization.

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

Transmitir chaves com segurança

Chaves API nunca devem estar em URLs, histórico do navegador, registros de proxy ou referências de origem. Por isso, parâmetros de consulta não são aceitos.

Pontos de acesso

Pontos de acesso JSON claros para pesquisa, conta e faturamento.

GET

/api/search.php

Pesquisa códigos, números de telefone, localidades, países e números de serviço ou emergência.

Parâmetro	Descrição
q	Termo de pesquisa, por exemplo `030`, `Berlin`, `+44`, `0800`.
limit	Opcional, de 1 a 50 resultados. Padrão: 12.

GET

/api/internationalize.php

Converte um número local de um país em um formato internacional copiável.

Parâmetro	Descrição
number	Número local, por exemplo `0343 222 1234`.
country	Código ISO do país do número, por exemplo `GB`, `DE`, `AT`. Padrão: `DE`.

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

Retorna o estado e as contagens atuais dos dados.

GET

/api/billing/plans.php

Retorna os planos API disponíveis, limites e estado do PayPal.

POST

/api/account/api-keys.php

Cria uma chave API para usuários conectados e verificados.

Formato de resposta

Cada resultado contém dados para exibição, validação e formatação.

codeCódigo de chamada ou faixa de números, por exemplo 030 ou +49.

nameLocalidade, país, serviço ou designação de emergência.

kindOrt, Land, Region, Dienst, Notruf.

local_formatFormato nacional de exibição recomendado.

international_formatFormato internacional de exibição recomendado.

adviceOrientação clara sobre custos, uso ou forma de discagem.

Planos de API

Cotas mensais previsíveis com uso gratuito justo.

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.