Referencia de la API para desarrolladores
Genere números de prueba mediante sencillas solicitudes HTTP GET.
Endpoint
Envíe solicitudes HTTP GET a la siguiente URL:
GEThttps://phone-number.loveyouall.qzz.io/api/generate
Prueba en línea (Try It)
Rellene los parámetros abajo y llame directamente a la API real para ver la respuesta JSON.
Parámetros de consulta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
country | string | No | Código de país. Admite "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL". Valor por defecto: "US". |
region | string | No | Nombre de región/estado/operador (p. ej. "California", "Ontario", "China Mobile"). No distingue mayúsculas. |
city | string | No | Nombre de ciudad o prefijo/código específico (p. ej. "Los Angeles", "138"). No distingue mayúsculas. Requiere especificar region. |
quantity | integer | No | Cantidad de números a generar. Rango: 1–1000 (los valores superiores se truncan). Valor por defecto: 10. |
customPrefix | string | No | Dígitos de prefijo personalizados (solo dígitos, 0-9). Opcional. |
safetyMode | string | No | Modo de seguridad. Admite "realistic" (reglas realistas) y "safe" (series ficticias reservadas, p. ej. 555-XXXX). Valor por defecto: "realistic". |
uniqueOnly | boolean | No | Generar solo números únicos. Admite "true" o "false". Valor por defecto: "true". |
Ejemplos de integración
Elija su lenguaje o herramienta preferidos para integrar la API:
curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"Formato de respuesta
Devuelve una matriz JSON de objetos de número. Cada objeto incluye campos localizados, formato de visualización y cadena E.164 estándar.
[
{
"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 respuesta
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único UUID v4 del registro. |
country | string | Código de país de dos letras (p. ej. US, CN). |
region | string | Nombre de estado/provincia/operador, p. ej. California o China Mobile. |
regionCode | string | Código corto de región, p. ej. CA para California. |
areaCode | string | Código de área o prefijo de número, p. ej. 213 o 138. |
city | string | Nombre de ciudad o segmento de prefijo, p. ej. Los Angeles o 138. |
display | string | Número formateado legible, p. ej. +1 (213) 555-1234. |
e164 | string | Formato E.164 estándar, p. ej. +12135551234. |
Códigos de error
La API usa códigos de estado HTTP estándar y devuelve siempre un cuerpo JSON con un campo "error" en caso de fallo.
| Código de estado | Cuándo ocurre | Cuerpo de respuesta |
|---|---|---|
400 | Código de país no admitido | {"error":"Unsupported country code: XX"} |
400 | Región o ciudad desconocida para el país seleccionado | {"error":"Unknown region ... for country US"} |
400 | customPrefix contiene caracteres no numéricos | {"error":"customPrefix must contain digits only"} |
400 | city proporcionado sin region | {"error":"city requires region"} |
500 | Error interno durante la generación | {"error":"Internal Server Error"} |
Límites de uso
- Gratuito y sin autenticación, no se requiere clave API
- Máximo 1 000 números por solicitud (los valores superiores se truncan)
- Valores por defecto: country=US, quantity=10, safetyMode=realistic, uniqueOnly=true
- safetyMode=safe usa series ficticias reservadas (p. ej. 555-XXXX) que nunca pertenecen a abonados reales