Riferimento API per sviluppatori
Genera numeri di test in modo programmatico con semplici richieste HTTP GET.
Endpoint
Invia richieste HTTP GET al seguente URL:
GEThttps://phone-number.loveyouall.qzz.io/api/generate
Prova online (Try It)
Compila i parametri qui sotto e chiama direttamente l'API reale per vedere la risposta JSON.
Parametri di query
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
country | string | No | Codice paese. Supporta "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL". Valore predefinito: "US". |
region | string | No | Nome di regione/stato/operatore (es. "California", "Ontario", "China Mobile"). Non fa distinzione tra maiuscole e minuscole. |
city | string | No | Nome di città o prefisso/codice specifico (es. "Los Angeles", "138"). Non fa distinzione tra maiuscole e minuscole. Richiede di specificare region. |
quantity | integer | No | Numero di record da generare. Intervallo: 1–1000 (i valori oltre 1000 vengono troncati). Valore predefinito: 10. |
customPrefix | string | No | Cifre di prefisso personalizzate (solo cifre, 0-9). Opzionale. |
safetyMode | string | No | Modalità di sicurezza. Supporta "realistic" (regole realistiche) e "safe" (serie fittizie riservate, es. 555-XXXX). Valore predefinito: "realistic". |
uniqueOnly | boolean | No | Generare solo numeri unici. Supporta "true" o "false". Valore predefinito: "true". |
Esempi di integrazione
Scegli il tuo linguaggio o strumento preferito per integrare l'API:
curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"Formato di risposta
Restituisce un array JSON di oggetti numerici. Ogni oggetto include campi localizzati, formato di visualizzazione e stringa E.164 standard.
[
{
"id": "c852d129-4112-4981-8ddb",
"country": "US",
"region": "California",
"regionCode": "CA",
"city": "Los Angeles",
"areaCode": "213",
"display": "+1 (213) 932-8419",
"e164": "+12139328419"
}
]Campi di risposta
| Campo | Tipo | Descrizione |
|---|---|---|
id | string | Identificatore univoco UUID v4 del record. |
country | string | Codice paese a due lettere (es. US, CN). |
region | string | Nome di stato/provincia/operatore, es. California o China Mobile. |
regionCode | string | Codice breve di regione, es. CA per California. |
areaCode | string | Codice di area o prefisso di numero, es. 213 o 138. |
city | string | Nome di città o segmento di prefisso, es. Los Angeles o 138. |
display | string | Numero formattato leggibile, es. +1 (213) 555-1234. |
e164 | string | Formato E.164 standard, es. +12135551234. |
Codici di errore
L'API usa i codici di stato HTTP standard e restituisce sempre un corpo JSON con un campo "error" in caso di errore.
| Codice di stato | Quando si verifica | Corpo della risposta |
|---|---|---|
400 | Codice paese non supportato | {"error":"Unsupported country code: XX"} |
400 | Regione o città sconosciuta per il paese selezionato | {"error":"Unknown region ... for country US"} |
400 | customPrefix contiene caratteri non numerici | {"error":"customPrefix must contain digits only"} |
400 | city fornito senza region | {"error":"city requires region"} |
500 | Errore interno durante la generazione | {"error":"Internal Server Error"} |
Limiti di utilizzo
- Gratuito e senza autenticazione, nessuna chiave API richiesta
- Massimo 1.000 numeri per richiesta (i valori superiori vengono troncati)
- Valori predefiniti: country=US, quantity=10, safetyMode=realistic, uniqueOnly=true
- safetyMode=safe usa serie fittizie riservate (es. 555-XXXX) che non appartengono mai ad abbonati reali