Référence de l’API développeur
Générez des numéros de test par programmation via de simples requêtes HTTP GET.
Point de terminaison
Envoyez des requêtes HTTP GET à l’URL suivante :
GEThttps://phone-number.loveyouall.qzz.io/api/generate
Test en ligne (Try It)
Remplissez les paramètres ci-dessous et appelez directement l’API réelle pour voir la réponse JSON.
Paramètres de requête
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
country | string | Non | Code pays. Prend en charge "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL". Valeur par défaut : "US". |
region | string | Non | Nom de la région/État/opérateur (ex. "California", "Ontario", "China Mobile"). Insensible à la casse. |
city | string | Non | Nom de ville ou préfixe/indicatif spécifique (ex. "Los Angeles", "138"). Insensible à la casse. Requiert la présence de region. |
quantity | integer | Non | Nombre de numéros à générer. Plage : 1–1000 (les valeurs supérieures sont tronquées). Valeur par défaut : 10. |
customPrefix | string | Non | Chiffres de préfixe personnalisés (chiffres uniquement, 0-9). Facultatif. |
safetyMode | string | Non | Mode de sécurité. Prend en charge "realistic" (règles réalistes) et "safe" (plages fictives réservées, ex. 555-XXXX). Valeur par défaut : "realistic". |
uniqueOnly | boolean | Non | Générer uniquement des numéros uniques. Prend en charge "true" ou "false". Valeur par défaut : "true". |
Exemples d’intégration
Choisissez votre langage ou outil préféré pour intégrer l’API :
curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"Format de réponse
Renvoie un tableau JSON d’objets de numéros. Chaque objet contient des champs localisés, le format d’affichage et la chaîne E.164 standardisée.
[
{
"id": "c852d129-4112-4981-8ddb",
"country": "US",
"region": "California",
"regionCode": "CA",
"city": "Los Angeles",
"areaCode": "213",
"display": "+1 (213) 932-8419",
"e164": "+12139328419"
}
]Champs de réponse
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant unique UUID v4 de l’enregistrement. |
country | string | Code pays à deux lettres (ex. US, CN). |
region | string | Nom de l’État/province/opérateur, ex. California ou China Mobile. |
regionCode | string | Code court de région, ex. CA pour la Californie. |
areaCode | string | Indicatif ou préfixe de numéro, ex. 213 ou 138. |
city | string | Nom de ville ou segment de préfixe, ex. Los Angeles ou 138. |
display | string | Numéro formaté lisible, ex. +1 (213) 555-1234. |
e164 | string | Format E.164 standard, ex. +12135551234. |
Codes d’erreur
L’API utilise les codes de statut HTTP standard et renvoie toujours un corps JSON avec un champ "error" en cas d’échec.
| Code de statut | Déclenchement | Corps de réponse |
|---|---|---|
400 | Code pays non pris en charge | {"error":"Unsupported country code: XX"} |
400 | Région ou ville inconnue pour le pays sélectionné | {"error":"Unknown region ... for country US"} |
400 | customPrefix contient des caractères non numériques | {"error":"customPrefix must contain digits only"} |
400 | city fourni sans region | {"error":"city requires region"} |
500 | Erreur interne pendant la génération | {"error":"Internal Server Error"} |
Limites d’utilisation
- Gratuit et sans authentification, aucune clé API requise
- Maximum 1 000 numéros par requête (les valeurs supérieures sont tronquées)
- Valeurs par défaut : country=US, quantity=10, safetyMode=realistic, uniqueOnly=true
- safetyMode=safe utilise des plages fictives réservées (ex. 555-XXXX) qui n’appartiennent jamais à de vrais abonnés