Geo API

Telefon numarası doğrulama API

Bir telefon numarası gönderin; Geo API numaranın geçerli olup olmadığını, ülkesini ve türünü (cep, sabit hat) söyler ve onu E.164, ulusal ve uluslararası biçimde döndürür. Kayıt formlarında yanlış numarayı kaydetmeden yakalamak ve veritabanındaki numaraları tek biçime getirmek için.

Nasıl çalışır

/v1/phone?number= numarayı ülkelerin numaralandırma planına göre denetler. Numara + ile başlıyorsa ülkesi ülke kodundan anlaşılır; 0532 ile başlayan yerel yazılmış bir numara için country=TR ile varsayılan ülkeyi verin.

valid numaranın o ülkenin planında kullanılan bir aralıkta olduğunu, possible uzunluğunun uygun olduğunu söyler. e164 alanı veritabanında saklamak, national ve international alanları ekranda göstermek içindir; type mobile, fixed_line, toll_free gibi bir tür verir.

Neyi doğrulamaz

Doğrulama numaranın biçimine ve numaralandırma planına bakar; hattın açık olduğunu, kime ait olduğunu ya da SMS alıp alamadığını söylemez. Bunun için numaraya SMS ile bir doğrulama kodu gönderin.

Kaynak, Google'ın libphonenumber kütüphanesinin numara planı verisidir ve dünyadaki ülkelerin numara planlarını kapsar.

Örnek istek ve yanıt

Yerel biçimde yazılmış bir Türk cep numarası; country=TR varsayılan ülkeyi verir. Anahtar gerekmez.

İstek

curl "https://api.forlab.io/geo/v1/phone?number=05321234567&country=TR"

Yanıttan bir kesit

{
  "data": {
    "valid": true,
    "possible": true,
    "e164": "+905321234567",
    "national": "0532 123 45 67",
    "international": "+90 532 123 45 67",
    "country": "TR",
    "type": "mobile"
  },
  "meta": { … }
}

Aynı iş Apify Actor ile

Anahtar almadan ya da toplu iş için Geo Reference Actor'üne bir liste verin; her öğe bir sonuç satırı olur ve gönderdiğiniz değer satırda kalır. Örnek girdi:

{"operation": "phone", "items": [{"number": "+4915112345678"}, {"number": "05321234567", "country": "TR"}]}

Ne kadar tutar

  • Anahtarsız: IPv4 adresi ya da IPv6 /64 başına UTC gününde 1.000 istek ücretsiz; bu hak bütün anahtarsız uç noktalarda (meta, countries, countries/{cc}, places, places/{id}, phone) ortaktır.
  • Apify Actor (phone işlemi): 1.000 numara için 0,10 $.

Apify'da kullandıkça ödersiniz: yalnız yanıtlanan sorgular ücretlenir, isteğe dönüşemeyen öğeler ücretsizdir, her çalıştırmaya ayrıca 0,001 $ başlangıç ücreti eklenir. Apify'ın ücretsiz planındaki aylık 5 $ kredi yaklaşık 16.000 koordinat sorgusuna yeter. Doğrudan API anahtarı için api@forlab.io adresine yazın.

Sık sorulan sorular

Numaranın kullanımda olduğunu doğrular mı?

Hayır. Biçimi ve numaralandırma planını denetler; hattın açık olduğunu ya da kime ait olduğunu söylemez. Bunun için numaraya SMS ile bir kod gönderin.

Geçersiz bir numarada yanıt ne olur?

valid: false döner ve biçimlendirilmiş alanlar gelmez; possible numaranın uzunluğunun yine de uygun olup olmadığını söyler. Numara hiç çözümlenemezse reason alanı nedenini verir (too_short, too_long gibi). HTTP durumu yine 200'dür: geçersiz numara bir istek hatası sayılmaz.

Hangi biçimde saklamalıyım?

e164 alanını (+905321234567) saklayın: ülke kodunu içerir, boşluk ve parantez taşımaz, her ülkede aynı biçimdedir. Ekranda national ya da international alanını gösterin.

Bir numara listesini toplu temizleyebilir miyim?

Evet. Apify'daki Geo Reference Actor'üne numara listesini verin: her numara bir sonuç satırı olur ve gönderdiğiniz değer input alanında kalır.

Geo API ile başka neler yapılır