Дані телефонних кодів у JSON

Надійно визначайте телефонні номери, коди й країни.

API phonecode.app надає структуровані дані про місцеві й міжнародні телефонні коди, сервісні та екстрені номери, а також перетворення місцевих номерів у міжнародний формат. Для магазинів, CRM, засобів підтримки, форм потенційних клієнтів і внутрішньої якості даних.

Створити ключ Швидкий початок

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 Записи

5 200 Місцеві мережі Німеччини

206 країн і територій

76 Сервісні та екстрені діапазони

382 Мобільні діапазони

Швидкий початок

Перший запит за кілька хвилин.

Підтвердьте обліковий запис

Зареєструйте обліковий запис клієнта й підтвердьте електронну адресу.

Створити ключ

Створіть ключ API. У відкритому вигляді він показується лише один раз.

Отримайте JSON

Надсилайте ключ лише як Bearer Token у заголовку Authorization.

Bearer Token

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

Передавайте ключі безпечно

Ключі API не повинні потрапляти в URL, історію браузера, журнали проксі чи адреси переходів. Тому параметри запиту не приймаються.

Кінцеві точки

Зрозумілі кінцеві точки JSON для пошуку, облікових записів і оплати.

GET

/api/search.php

Шукає телефонні коди, номери, населені пункти, країни, сервісні та екстрені номери.

Параметр	Опис
q	Пошуковий запит, наприклад `030`, `Berlin`, `+44`, `0800`.
limit	Необов’язково, від 1 до 50 результатів. Типово: 12.

GET

/api/internationalize.php

Перетворює місцевий номер країни на міжнародний формат для копіювання.

Параметр	Опис
number	Місцевий номер, наприклад `0343 222 1234`.
country	Код країни номера за ISO, наприклад `GB`, `DE`, `AT`. Типово: `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

Повертає стан і поточні лічильники даних.

GET

/api/billing/plans.php

Повертає доступні пакети API, ліміти та стан PayPal.

POST

/api/account/api-keys.php

Створює ключ API для користувачів, які увійшли й підтвердили обліковий запис.

Формат відповіді

Кожен результат містить дані для відображення, перевірки й форматування.

codeТелефонний код або діапазон номерів, наприклад 030 чи +49.

nameНаселений пункт, країна, сервіс або назва екстреної служби.

kindOrt, Land, Region, Dienst, Notruf.

local_formatРекомендований національний формат відображення.

international_formatРекомендований міжнародний формат відображення.

adviceЗрозуміла порада про вартість, використання чи спосіб набору.

плани API

Передбачувані місячні квоти зі справедливим безкоштовним використанням.

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