Entwickler-API-Referenz
Generieren Sie Test-Telefonnummern programmatisch über einfache HTTP-GET-Anfragen.
API-Endpunkt
Senden Sie HTTP-GET-Anfragen an folgende URL:
GEThttps://phone-number.loveyouall.qzz.io/api/generate
Live-Test (Try It)
Parameter unten ausfüllen und die echte API direkt aufrufen, um die JSON-Antwort zu sehen.
Query-Parameter
| Parameter | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
country | string | Nein | Ländercode. Unterstützt "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL". Standard: "US". |
region | string | Nein | Name von Region/Bundesstaat/Betreiber (z. B. "California", "Ontario", "China Mobile"). Groß-/Kleinschreibung wird ignoriert. |
city | string | Nein | Stadtname oder 3-/2-stelliges Präfix (z. B. "Los Angeles", "138"). Groß-/Kleinschreibung wird ignoriert. Erfordert die Angabe von region. |
quantity | integer | Nein | Anzahl der zu generierenden Nummern. Bereich: 1–1000 (Werte über 1000 werden begrenzt). Standard: 10. |
customPrefix | string | Nein | Benutzerdefinierte Präfix-Ziffern (nur 0-9). Optional. |
safetyMode | string | Nein | Sicherheitsmodus. Unterstützt "realistic" (realistische Regeln) und "safe" (offiziell reservierte fiktive Testnummern, z. B. 555-XXXX). Standard: "realistic". |
uniqueOnly | boolean | Nein | Nur eindeutige Nummern generieren. Unterstützt "true" oder "false". Standard: "true". |
Integrationsbeispiele
Wählen Sie Ihre bevorzugte Sprache oder Ihr Werkzeug für die API-Integration:
curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"Antwortformat
Gibt ein JSON-Array mit Telefonnummern-Datensätzen zurück. Jeder Datensatz enthält lokalisierte Felder, Anzeigeformat und standardisiertes E.164-Format.
[
{
"id": "c852d129-4112-4981-8ddb",
"country": "US",
"region": "California",
"regionCode": "CA",
"city": "Los Angeles",
"areaCode": "213",
"display": "+1 (213) 932-8419",
"e164": "+12139328419"
}
]Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Eindeutige UUID-v4-Kennung des Datensatzes. |
country | string | Zweibuchstabiger Ländercode (z. B. US, CN). |
region | string | Name von Bundesstaat/Provinz/Betreiber, z. B. California oder China Mobile. |
regionCode | string | Kurzer Regionscode, falls vorhanden, z. B. CA für Kalifornien. |
areaCode | string | Vorwahl oder Nummernpräfix, z. B. 213 oder 138. |
city | string | Stadtname oder Präfixsegment, z. B. Los Angeles oder 138. |
display | string | Lesbare formatierte Nummer, z. B. +1 (213) 555-1234. |
e164 | string | Standard-E.164-Format, z. B. +12135551234. |
Fehlercodes
Die API verwendet standardmäßige HTTP-Statuscodes und gibt bei Fehlern immer ein JSON-Objekt mit "error"-Feld zurück.
| Statuscode | Auslöser | Antwortbody |
|---|---|---|
400 | Nicht unterstützter Ländercode | {"error":"Unsupported country code: XX"} |
400 | Unbekannte Region oder Stadt für das gewählte Land | {"error":"Unknown region ... for country US"} |
400 | customPrefix enthält Nicht-Ziffern-Zeichen | {"error":"customPrefix must contain digits only"} |
400 | city angegeben, ohne region zu setzen | {"error":"city requires region"} |
500 | Interner Fehler während der Generierung | {"error":"Internal Server Error"} |
Nutzungsgrenzen
- Kostenlos und ohne Authentifizierung, kein API-Key erforderlich
- Maximal 1.000 Nummern pro Anfrage (höhere Werte werden begrenzt)
- Standards: country=US, quantity=10, safetyMode=realistic, uniqueOnly=true
- safetyMode=safe verwendet offiziell reservierte fiktive Testnummern (z. B. 555-XXXX), die nie echten Nutzern gehören