Referência da API para desenvolvedores

Gere números de teste de forma programática com simples solicitações HTTP GET.

Endpoint

Envie solicitações HTTP GET para a seguinte URL:

GEThttps://phone-number.loveyouall.qzz.io/api/generate

Teste online (Try It)

Preencha os parâmetros abaixo e chame diretamente a API real para ver a resposta JSON.

Parâmetro: country

quantity

safetyMode

region

city

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Descrição
`country`	string	Não	Código do país. Suporta "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL". Padrão: "US".
`region`	string	Não	Nome da região/estado/operadora (ex.: "California", "Ontario", "China Mobile"). Não diferencia maiúsculas de minúsculas.
`city`	string	Não	Nome da cidade ou prefixo/código específico (ex.: "Los Angeles", "138"). Não diferencia maiúsculas de minúsculas. Requer especificar region.
`quantity`	integer	Não	Quantidade de registros a gerar. Intervalo: 1–1000 (valores acima de 1000 são limitados). Padrão: 10.
`customPrefix`	string	Não	Dígitos de prefixo personalizados (somente dígitos, 0-9). Opcional.
`safetyMode`	string	Não	Modo de segurança. Suporta "realistic" (regras realistas) e "safe" (faixas fictícias oficiais reservadas, ex.: 555-XXXX). Padrão: "realistic".
`uniqueOnly`	boolean	Não	Gerar somente números únicos. Suporta "true" ou "false". Padrão: "true".

Exemplos de integração

Escolha seu idioma ou ferramenta preferidos para integrar a API:

curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"

Formato de resposta

Retorna um array JSON de objetos de número. Cada objeto contém campos localizados, formato de exibição e string E.164 padronizada.

[
  {
    "id": "c852d129-4112-4981-8ddb",
    "country": "US",
    "region": "California",
    "regionCode": "CA",
    "city": "Los Angeles",
    "areaCode": "213",
    "display": "+1 (213) 932-8419",
    "e164": "+12139328419"
  }
]

Campos de resposta

Campo	Tipo	Descrição
`id`	string	Identificador exclusivo UUID v4 do registro.
`country`	string	Código do país com duas letras (ex.: US, CN).
`region`	string	Nome do estado/província/operadora, ex.: California ou China Mobile.
`regionCode`	string	Código curto da região, ex.: CA para Califórnia.
`areaCode`	string	Código de área ou prefixo do número, ex.: 213 ou 138.
`city`	string	Nome da cidade ou segmento de prefixo, ex.: Los Angeles ou 138.
`display`	string	Número formatado legível, ex.: +1 (213) 555-1234.
`e164`	string	Formato E.164 padrão, ex.: +12135551234.

Códigos de erro

A API usa códigos de status HTTP padrão e sempre retorna um corpo JSON com um campo "error" em caso de falha.

Código de status	Quando ocorre	Corpo da resposta
`400`	Código de país não suportado	`{"error":"Unsupported country code: XX"}`
`400`	Região ou cidade desconhecida para o país selecionado	`{"error":"Unknown region ... for country US"}`
`400`	customPrefix contém caracteres não numéricos	`{"error":"customPrefix must contain digits only"}`
`400`	city fornecido sem region	`{"error":"city requires region"}`
`500`	Erro interno durante a geração	`{"error":"Internal Server Error"}`

Limites de uso

Gratuito e sem autenticação, nenhuma chave de API necessária
Máximo de 1.000 números por solicitação (valores maiores são limitados)
Padrões: country=US, quantity=10, safetyMode=realistic, uniqueOnly=true
safetyMode=safe usa faixas fictícias oficiais reservadas (ex.: 555-XXXX) que nunca pertencem a assinantes reais