Uluslararası telefon verisi
Tek numara, tutarlı çıktı
Ulusal, uluslararası veya düzensiz yazılmış girdileri kabul edin; 242 ülke ve bölge için standart format ve doğrulama verisi alın.
+1 212 867 5309+12128675309isValid ve isPossibleGirdi parametreleri
Numara ve bölge bağlamı
| Parametre | Gereklilik | Açıklama |
|---|---|---|
number | Zorunlu | Ulusal, uluslararası veya E.164 biçimindeki telefon numarası. |
address | Koşullu | Ulusal numarayı yorumlamak için ISO ülke kodu, ülke, şehir veya bölge. |
number, + ve uluslararası ülke koduyla başlamıyorsa TR, Türkiye veya İstanbul gibi bağlam gönderin.
TRTürkiyeİstanbulNew YorkGermanySorgu parametresiyle kimlik doğrulama
Temel GET sorgusu
curl "https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=%2B12128675309&address=US"+ işaretini %2B, boşluğu %20 olarak kodlayın. Elle metin birleştirmek yerine URL/URLSearchParams kullanın.Bearer ile kimlik doğrulama
Sunucu taraflı POST sorgusu
Numarayı ve isteğe bağlı adresi JSON gövdesinde, API anahtarını Authorization üstbilgisinde gönderin.
curl -X POST "https://api.genderapi.io/api/phone" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"number":"+12128675309","address":"US"}'API yanıtı
Doğrulama, formatlama ve numara bilgileri
{
"status": true, "regionCode": "US", "countryCode": 1,
"national": "(212) 867-5309", "international": "+1 212-867-5309",
"e164": "+12128675309", "isValid": true, "isPossible": true,
"numberType": "FIXED_LINE_OR_MOBILE", "location": "New York City (Manhattan)"
}Yanıt alanları
| Alan | Tür | Açıklama |
|---|---|---|
status | boolean | Sorgunun başarıyla tamamlanıp tamamlanmadığı. |
remaining_credits | integer | Sorgudan sonra kalan kredi. |
expires | integer | Kredi bitiş zamanının UNIX değeri. |
duration | string | Sunucu işlem süresi. |
regionCode | string | ISO 3166-1 alpha-2 bölge kodu. |
countryCode | integer | Uluslararası telefon ülke kodu. |
country | string | Ülke adı. |
national | string | Ulusal gösterim biçimi. |
international | string | Uluslararası gösterim biçimi. |
e164 | string | Standart E.164 biçimi. |
isValid | boolean | Numaranın bölgesel kurallara göre geçerli olup olmadığı. |
isPossible | boolean | Numaranın yapısal olarak mümkün olup olmadığı. |
numberType | string | Belirlenen telefon numarası türü. |
nationalSignificantNumber | string | Ülke kodu bulunmayan ulusal numara. |
rawInput | string | Sorguda gönderilen özgün değer. |
isGeographical | boolean | Numaranın coğrafi bir alanla ilişkilendirilip ilişkilendirilemediği. |
areaCode | string | Belirlenen alan kodu. |
location | string | Alan koduyla ilişkilendirilen konum. |
Sınıflandırma referansı
Telefon numarası türleri
FIXED_LINECoğrafi konuma bağlı sabit hat.
MOBILECep telefonu numarası.
FIXED_LINE_OR_MOBILENumaralandırma planında sabit ve mobil hat ayrıştırılamıyor.
TOLL_FREEÜcretsiz arama numarası.
PREMIUM_RATEÖzel ücretli servis numarası.
SHARED_COSTArama ücretinin paylaşıldığı numara.
VOIPİnternet üzerinden ses numarası.
PERSONAL_NUMBERBaşka bir hatta yönlendirilebilen kişisel numara.
PAGERÇağrı cihazı numarası.
UANOrtak kurumsal iletişim için evrensel erişim numarası.
VOICEMAILSesli mesaj erişim numarası.
UNKNOWNNumara türü belirlenemedi.
Sık sorulan sorular
Telefon API hakkında
Telefon numarası doğrulama API'si ne yapar?
Telefon numaralarını doğrular, standart biçime dönüştürür; ülke, numara türü ve mevcutsa coğrafi bilgileri döndürür.
isValid ile isPossible arasındaki fark nedir?
isValid bölgesel numaralandırma kurallarını denetler. isPossible ise yapı geçerli görünse de numaranın doğruluğu kesinleşmediğinde kullanılabilir.
address alanı ne zaman gereklidir?
Numara artı işareti ve uluslararası ülke koduyla başlamıyorsa ISO ülke kodu, ülke, şehir veya bölge bağlamı gönderin.
Özel karakterleri nasıl göndermeliyim?
GET parametrelerindeki artı işareti, boşluk ve özel karakterleri URL ile kodlayın. JSON POST gövdelerini HTTP istemciniz kodlar.
Sıradaki referans