Мировая экономика.

    ← Вернуться к карте

    Разработчикам

    API и встраиваемые виджеты для доступа к экономическим данным 179 стран. Для использования нужен бесплатный токен.

    2 · Виджет для встраивания

    Виджет — это компактный блок с данными страны, который вставляется на ваш сайт через <iframe>. Передайте токен в параметре token.

    Пример кода

    <iframe
  src="https://world-economy.pages.dev/widget/?c=us&token=YOUR_TOKEN&metrics=gdp,inflation,debt"
  width="360" height="240" frameborder="0">
</iframe>

    Параметры

    ПараметрОписаниеПример
    cКод страны (ISO 3166-1 alpha-2)us, de, ru
    tokenВаш токен (обязательно)we_a1b2...
    metricsПоказатели через запятуюgdp,inflation,debt,index
    themeТема оформленияlight / dark

    Живой предпросмотр

    3 · REST API

    Прямой доступ к данным в формате JSON. Токен передаётся в заголовке X-API-Token или в параметре ?token=.

    Базовый URL

    https://worldbank-proxy.fnemoy.workers.dev

    Эндпоинты

    МетодПутьТокенОписание
    GET/data/:isoдаДанные страны
    GET/widget-data?c=:isoдаДанные для виджета
    GET/verify?token=:t—Проверить токен
    GET/fx?base=USDнетКурсы валют
    GET/api/v2/country/...нетПрокси World Bank

    Пример: fetch (JavaScript)

    const res = await fetch(
  'https://worldbank-proxy.fnemoy.workers.dev/data/us',
  { headers: { 'X-API-Token': 'YOUR_TOKEN' } }
);
const data = await res.json();
console.log(data);

    Пример: curl

    curl -H "X-API-Token: YOUR_TOKEN" \
  https://worldbank-proxy.fnemoy.workers.dev/data/de

    Пример: Python

    import requests

headers = {"X-API-Token": "YOUR_TOKEN"}
res = requests.get(
    "https://worldbank-proxy.fnemoy.workers.dev/data/de",
    headers=headers
)
data = res.json()
print(data)

    Тестировать сейчас

    Ответ появится здесь…

    4 · Коды ошибок

    КодЗначение
    401 no_tokenТокен не передан
    401 invalid_tokenТокен не найден в базе
    401 rate_limit_exceededПревышен дневной лимит (10/день для Free)
    400 invalid_emailНекорректный email при регистрации