Ontwikkelaars-API-referentie
Genereer testtelefoonnummers programmatisch via eenvoudige HTTP-GET-aanvragen.
API-endpoint
Stuur HTTP-GET-aanvragen naar de volgende URL:
GEThttps://phone-number.loveyouall.qzz.io/api/generate
Online testen (Try It)
Vul hieronder de parameters in en roep de echte API rechtstreeks aan om de JSON-respons te zien.
Queryparameters
| Parameter | Type | Verplicht | Beschrijving |
|---|---|---|---|
country | string | Nee | Landcode. Ondersteunt "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL". Standaard: "US". |
region | string | Nee | Naam van regio/staat/operator (bijv. "California", "Ontario", "China Mobile"). Hoofdlettergevoeligheid wordt genegeerd. |
city | string | Nee | Stadsnaam of specifiek prefix/netnummer (bijv. "Los Angeles", "138"). Hoofdlettergevoeligheid wordt genegeerd. Vereist dat region is opgegeven. |
quantity | integer | Nee | Aantal te genereren records. Bereik: 1–1000 (waarden boven 1000 worden afgekapt). Standaard: 10. |
customPrefix | string | Nee | Aangepaste prefixcijfers (alleen cijfers, 0-9). Optioneel. |
safetyMode | string | Nee | Veiligheidsmodus. Ondersteunt "realistic" (realistische regels) en "safe" (officieel gereserveerde fictieve testnummers, bijv. 555-XXXX). Standaard: "realistic". |
uniqueOnly | boolean | Nee | Alleen unieke nummers genereren. Ondersteunt "true" of "false". Standaard: "true". |
Integratievoorbeelden
Kies uw favoriete taal of hulpmiddel om de API te integreren:
curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"Antwoordformaat
Geeft een JSON-array met telefoonnummerrecords terug. Elk record bevat gelokaliseerde velden, weergaveformaat en gestandaardiseerde E.164-strings.
[
{
"id": "c852d129-4112-4981-8ddb",
"country": "US",
"region": "California",
"regionCode": "CA",
"city": "Los Angeles",
"areaCode": "213",
"display": "+1 (213) 932-8419",
"e164": "+12139328419"
}
]Responsvelden
| Veld | Type | Beschrijving |
|---|---|---|
id | string | Unieke UUID-v4-id van het record. |
country | string | Tweeletterige landcode (bijv. US, CN). |
region | string | Naam van staat/provincie/operator, bijv. California of China Mobile. |
regionCode | string | Korte regio-code indien aanwezig, bijv. CA voor Californië. |
areaCode | string | Netnummer of nummerprefix, bijv. 213 of 138. |
city | string | Stadsnaam of prefixsegment, bijv. Los Angeles of 138. |
display | string | Leesbaar geformatteerd nummer, bijv. +1 (213) 555-1234. |
e164 | string | Standaard E.164-formaat, bijv. +12135551234. |
Foutcodes
De API gebruikt standaard HTTP-statuscodes en geeft bij fouten altijd een JSON-body met een "error"-veld terug.
| Statuscode | Wanneer dit optreedt | Responsbody |
|---|---|---|
400 | Niet-ondersteunde landcode | {"error":"Unsupported country code: XX"} |
400 | Onbekende regio of stad voor het geselecteerde land | {"error":"Unknown region ... for country US"} |
400 | customPrefix bevat niet-numerieke tekens | {"error":"customPrefix must contain digits only"} |
400 | city opgegeven zonder region | {"error":"city requires region"} |
500 | Interne fout tijdens het genereren | {"error":"Internal Server Error"} |
Gebruikslimieten
- Gratis en zonder authenticatie, geen API-sleutel nodig
- Maximaal 1.000 nummers per aanvraag (hogere waarden worden afgekapt)
- Standaardwaarden: country=US, quantity=10, safetyMode=realistic, uniqueOnly=true
- safetyMode=safe gebruikt officieel gereserveerde fictieve testnummers (bijv. 555-XXXX) die nooit van echte abonnees zijn