Dane kierunkowe w JSON

Wiarygodnie rozpoznawaj numery telefonów, kierunkowe i kraje.

API phonecode.app udostępnia uporządkowane dane o lokalnych i międzynarodowych numerach kierunkowych, numerach usługowych i alarmowych oraz konwersję numerów lokalnych do formatu międzynarodowego. Przeznaczone dla sklepów, systemów CRM, narzędzi wsparcia, formularzy kontaktów handlowych i wewnętrznej jakości danych.

Utwórz klucz Szybki start

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 Rekordy

5 200 Niemieckie sieci lokalne

206 kraje i terytoria

76 Zakresy usługowe i alarmowe

382 Zakresy komórkowe

Szybki start

Pierwsze zapytanie w kilka minut.

Potwierdź konto

Zarejestruj konto klienta i potwierdź adres e-mail.

Utwórz klucz

Utwórz klucz API. Zostanie pokazany w postaci jawnej tylko raz.

Pobierz JSON

Wysyłaj klucz wyłącznie jako Bearer Token w nagłówku Authorization.

Bearer Token

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

Bezpiecznie przesyłaj klucze

Klucze API nigdy nie powinny trafiać do adresów URL, historii przeglądarki, logów proxy ani adresów odsyłających. Dlatego parametry zapytania nie są akceptowane.

Punkty końcowe

Przejrzyste punkty końcowe JSON do wyszukiwania, konta i rozliczeń.

GET

/api/search.php

Wyszukuje kierunkowe, numery telefonów, miejscowości, kraje oraz numery usługowe i alarmowe.

Parametr	Opis
q	Szukana fraza, np. `030`, `Berlin`, `+44`, `0800`.
limit	Opcjonalnie, od 1 do 50 wyników. Domyślnie: 12.

GET

/api/internationalize.php

Konwertuje lokalny numer telefonu danego kraju do międzynarodowego formatu, który można skopiować.

Parametr	Opis
number	Numer lokalny, np. `0343 222 1234`.
country	Kod ISO kraju numeru, np. `GB`, `DE`, `AT`. Domyślnie: `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

Zwraca stan i aktualne liczniki danych.

GET

/api/billing/plans.php

Zwraca dostępne pakiety API, limity i stan PayPal.

POST

/api/account/api-keys.php

Tworzy klucz API dla zalogowanych i zweryfikowanych użytkowników.

Format odpowiedzi

Każdy wynik zawiera dane do wyświetlania, sprawdzania i formatowania.

codeNumer kierunkowy lub zakres numerów, np. 030 lub +49.

nameMiejscowość, kraj, usługa lub nazwa numeru alarmowego.

kindOrt, Land, Region, Dienst, Notruf.

local_formatZalecany krajowy format wyświetlania.

international_formatZalecany międzynarodowy format wyświetlania.

adviceZrozumiała wskazówka o kosztach, użyciu lub sposobie wybierania.

Plany API

Przewidywalne miesięczne limity z uczciwym bezpłatnym użyciem.

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