JSON olarak arama kodu verileri

Telefon numaralarını, arama kodlarını ve ülkeleri güvenilir biçimde tanıyın.

phonecode.app API; yerel alan kodları, uluslararası ülke kodları, hizmet ve acil durum numaraları için yapılandırılmış veriler ve yerel numaraların uluslararası biçime dönüştürülmesini sunar. Mağazalar, CRM sistemleri, destek araçları, potansiyel müşteri formları ve kurum içi veri kalitesi için tasarlanmıştır.

Anahtar oluştur Hızlı başlangıç

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

28.608 Kayıtlar

5.200 Alman yerel şebekeleri

206 ülkeler ve bölgeler

76 Hizmet ve acil durum aralıkları

382 Mobil numara aralıkları

Hızlı başlangıç

Dakikalar içinde ilk sorgunuz.

Hesabı doğrulayın

Müşteri hesabına kaydolun ve e-posta adresinizi doğrulayın.

Anahtar oluştur

API anahtarı oluşturun. Açık metin olarak yalnızca bir kez gösterilir.

JSON alın

Anahtarı yalnızca Authorization başlığında Bearer Token olarak gönderin.

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

Anahtarları güvenle aktarın

API anahtarları asla URL’lerde, tarayıcı geçmişinde, proxy günlüklerinde veya yönlendiren adreslerde bulunmamalıdır. Bu yüzden sorgu parametreleri kabul edilmez.

Uç noktalar

Arama, hesap ve faturalandırma için açık JSON uç noktaları.

GET

/api/search.php

Arama kodu, telefon numarası, yer, ülke, hizmet veya acil durum numarası arar.

Parametre	Açıklama
q	Arama terimi; örneğin `030`, `Berlin`, `+44`, `0800`.
limit	İsteğe bağlı, 1 ile 50 sonuç. Varsayılan: 12.

GET

/api/internationalize.php

Bir ülkenin yerel telefon numarasını kopyalanabilir uluslararası biçime dönüştürür.

Parametre	Açıklama
number	Yerel numara; örneğin `0343 222 1234`.
country	Numaranın ISO ülke kodu; örneğin `GB`, `DE`, `AT`. Varsayılan: `DE`.

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

Durumu ve güncel veri sayılarını döndürür.

GET

/api/billing/plans.php

Mevcut API paketlerini, sınırları ve PayPal durumunu döndürür.

POST

/api/account/api-keys.php

Oturum açmış ve doğrulanmış kullanıcılar için API anahtarı oluşturur.

Yanıt biçimi

Her sonuç görüntüleme, doğrulama ve biçimlendirme verilerini içerir.

codeAlan kodu veya numara aralığı; örneğin 030 ya da +49.

nameYer, ülke, hizmet veya acil durum adı.

kindOrt, Land, Region, Dienst, Notruf.

local_formatÖnerilen ulusal görüntüleme biçimi.

international_formatÖnerilen uluslararası görüntüleme biçimi.

adviceÜcret, kullanım veya çevirme yöntemi hakkında anlaşılır açıklama.

API planları

Adil ücretsiz kullanımla öngörülebilir aylık kotalar.

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.