Налаштування KrakenD API Gateway під ключ

Наша компанія займається розробкою, підтримкою та обслуговуванням сайтів будь-якої складності. Від простих односторінкових сайтів до масштабних кластерних систем, побудованих на мікро сервісах. Досвід розробників підтверджено сертифікатами від вендорів.

Розробка та обслуговування будь-яких видів сайтів:

Інформаційні сайти або веб-програми
Сайти візитки, landing page, корпоративні сайти, онлайн каталоги, квіз, промо-сайти, блоги, ресурси новин, інформаційні портали, форуми, агрегатори
Сайти або веб-програми електронної комерції
Інтернет-магазини, B2B-портали, маркетплейси, онлайн-обмінники, кешбек-сайти, біржі, дропшиппінг-платформи, парсери товарів
Веб-програми для управління бізнес-процесами
CRM-системи, ERP-системи, корпоративні портали, системи управління виробництвом, парсери інформації
Сайти або веб-програми електронних послуг
Дошки оголошень, онлайн-школи, онлайн-кінотеатри, конструктори сайтів, портали надання електронних послуг, відеохостинги, тематичні портали

Це лише деякі з технічних типів сайтів, з якими ми працюємо, і кожен із них може мати свої специфічні особливості та функціональність, а також бути адаптованим під конкретні потреби та цілі клієнта.

Послуги, які ми пропонуємо
Показано 1 з 1Усі 2062 послуг
Налаштування KrakenD API Gateway під ключ
Складний
~3-5 днів
Часті запитання

Наші компетенції:

Етапи розробки

Останні роботи

  • image_website-b2b-advance_0.webp
    Розробка сайту компанії B2B ADVANCE
    1360
  • image_web-applications_feedme_466_0.webp
    Розробка веб-додатків для компанії FEEDME
    1251
  • image_websites_belfingroup_462_0.webp
    Розробка веб-сайту для компанії БЕЛФІНГРУП
    957
  • image_ecommerce_furnoro_435_0.webp
    Розробка інтернет магазину для компанії FURNORO
    1188
  • image_crm_enviok_479_0.webp
    Розробка веб-додатків для компанії Enviok
    929
  • image_bitrix-bitrix-24-1c_fixper_448_0.webp
    Розробка веб-сайту для компанії ФІКСПЕР
    948

N+1 запитів та фрагментовані API: типова архітектурна біль

Ваше SPA робить 30 запитів на сторінку, N+1 query в GraphQL не вирішив проблему фрагментації API. Кожен мікросервіс віддає свої дані, клієнтський код обростає ланцюжками викликів. Ми — команда інженерів з 5-річним досвідом впровадження KrakenD. Наша спеціалізація — високонавантажені API Gateway, що обробляють до 70 000 RPS на одному ядрі. KrakenD — stateless API Gateway на Go з декларативною конфігурацією в одному JSON/YAML файлі. Його фішка — агрегація відповідей кількох backend-сервісів в одну відповідь клієнту (API composition). Це знижує затримки та спрощує клієнтський код.

Як KrakenD вирішує проблему агрегації API?

KrakenD об'єднує паралельні запити до бекендів в одну відповідь. Клієнт бачить лише один endpoint, а шлюз сам збирає дані. Це позбавляє необхідності писати BFF або використовувати костилі на кшталт server-side includes.

Чому KrakenD швидше за Kong?

У бенчмарках KrakenD показує до 70K RPS на ядро — в 2–3 рази вище, ніж Kong (25K RPS). Причина — мінімалістична кодова база на Go та відсутність плагінів, які гальмують обробку. Для high-load проєктів це критично: ви економите на залізі та зберігаєте низьку затримку. За даними офіційних бенчмарків KrakenD Benchmarks, різниця особливо помітна при агрегації кількох бекендів.

Агрегація в ділі

Типовий endpoint /api/v1/user-profile звертається до трьох сервісів: users, billing, prefs. KrakenD запускає їх паралельно та повертає об'єднаний JSON. У конфігу це виглядає так:

{
  "$schema": "https://www.krakend.io/schema/v3.json",
  "version": 3,
  "name": "MyApp API Gateway",
  "timeout": "3000ms",
  "cache_ttl": "300s",
  "output_encoding": "json",
  "port": 8080,
  "endpoints": [
    {
      "endpoint": "/api/v1/user-profile",
      "method": "GET",
      "output_encoding": "json",
      "backend": [
        {
          "url_pattern": "/users/{JWT_CLAIMS.user_id}",
          "host": ["http://users-service:3000"],
          "mapping": { "data": "user" }
        },
        {
          "url_pattern": "/subscriptions/active?user_id={JWT_CLAIMS.user_id}",
          "host": ["http://billing-service:3001"],
          "mapping": { "plan": "subscription_plan" }
        },
        {
          "url_pattern": "/preferences/{JWT_CLAIMS.user_id}",
          "host": ["http://prefs-service:3002"],
          "mapping": { "settings": "preferences" }
        }
      ],
      "extra_config": {
        "auth/validator": {
          "alg": "RS256",
          "jwk_url": "http://auth-service:4000/.well-known/jwks.json",
          "cache": true,
          "cache_duration": 300
        }
      }
    }
  ]
}

Клієнт робить один GET-запит і отримує {"user":{"id":"123","name":"Alice"},"subscription_plan":"pro","preferences":{"theme":"dark"}}. Без KrakenD довелося б робити 3 запити та об'єднувати на клієнті — зростання складності та часу завантаження.

Rate Limiting та Circuit Breaker

Для захисту бекендів від перевантажень ми налаштовуємо rate limiting (по IP або токену) та circuit breaker. Приклад конфігурації:

{
  "endpoint": "/api/v1/search",
  "backend": [{ "url_pattern": "/search", "host": ["http://search:3000"] }],
  "extra_config": {
    "qos/ratelimit/router": {
      "max_rate": 100,
      "client_max_rate": 10,
      "strategy": "ip",
      "capacity": 100,
      "client_capacity": 10
    },
    "qos/circuit-breaker": {
      "interval": 60,
      "timeout": 10,
      "max_errors": 5,
      "name": "search-cb",
      "log_status_change": true
    }
  }
}

Circuit breaker відключає проблемний бекенд на 10 секунд після 5 помилок, запобігаючи каскадним збоям. Помилки валідації JWT також відсікаються на рівні шлюзу, знижуючи навантаження на сервіси.

Кешування та додаткові трансформації

KrakenD підтримує кешування відповідей (cache_ttl) та трансформацію за допомогою Lua-скриптів або вбудованих фільтрів. Це дозволяє, наприклад, фільтрувати чутливі поля перед відправкою клієнту. Для частих запитів кеш може знизити затримку до 80%.

Процес налаштування KrakenD

Ми працюємо за чітким планом, щоб ви отримали стабільний шлюз без сюрпризів.

Аналіз та проектування архітектури

Вивчаємо вашу архітектуру: список сервісів, ендпоінти, вимоги до аутентифікації та безпеки. Складаємо схему агрегації та вибираємо стратегію кешування.

Встановлення та конфігурація

Встановлення через Docker:

docker run -p 8080:8080 \
  -v $PWD/krakend.json:/etc/krakend/krakend.json \
  devopsfaith/krakend:2.7 run -c /etc/krakend/krakend.json

Ми створюємо конфігурацію з вашими ендпоінтами, JWT-валідацією, rate limiting та circuit breaker. Використовуємо KrakenD Designer для візуальної перевірки.

Інтеграція моніторингу

Налаштовуємо метрики Prometheus та дашборди Grafana. Приклад секції моніторингу:

{
  "extra_config": {
    "telemetry/metrics": {
      "collection_time": "60s",
      "proxy_disabled": false,
      "router_disabled": false,
      "backend_disabled": false,
      "endpoint_disabled": false,
      "listen_address": ":9091"
    },
    "telemetry/opentelemetry": {
      "service_name": "krakend-gateway",
      "exporters": {
        "prometheus": [{ "port": 9090, "disable_metrics": false }],
        "otlp": [{
          "name": "jaeger",
          "host": "jaeger",
          "port": 4317,
          "use_http": false
        }]
      }
    }
  }
}

Ви отримуєте дашборди з LCP, TTFB, кількістю помилок та завантаженням бекендів.

Тестування та деплой

Проводимо навантажувальне тестування, перевіряємо агрегацію, timeout, circuit breaker. Після успішного тесту деплоїмо у ваше середовище (Kubernetes, bare metal, хмара).

Документація та навчання

Передаємо повну документацію: схему конфігурації, інструкцію з додавання ендпоінтів, адреси дашбордів. Проводимо семінар для вашої команди.

Що входить у налаштування?

Етап Результат
Аналіз Карта сервісів, схема агрегації, вимоги до безпеки
Конфігурація JSON-конфіг з ендпоінтами, JWT, rate limiting
Моніторинг Prometheus + Grafana дашборди, алерти
Тестування Звіт навантажувального тесту
Документація Опис конфігурації, інструкція з додавання ендпоінтів
Навчання Семінар для команди (1 година)
Підтримка 1 місяць після запуску

Чому обирають нас?

Ми — сертифіковані інженери з 5-річним досвідом роботи з KrakenD. Запустили 50+ проєктів, включаючи high-load системи з трафіком 100K RPS. Гарантуємо uptime 99.9% та передаємо проєкт з повною документацією. Завдяки агрегації та кешуванню наші клієнти економлять до 40% витрат на інфраструктуру. Окупність налаштування — зазвичай 3–4 місяці.

Показник Значення
Досвід на ринку Понад 5 років
Впроваджень API Gateway 50+
Середній час налаштування 2–3 дні
SLA по uptime 99.9%

Замовте налаштування KrakenD під ключ — від консультації до моніторингу. Оцінимо ваш проєкт за 1 день. Отримайте готовий шлюз з документацією та навчанням команди. Зв'яжіться з нами для початку.

Строки орієнтовно

Базове налаштування з агрегацією, JWT та rate limiting — 2–3 робочих дні. Складна конфігурація з трансформаціями та observability — 4–5 днів. Вартість розраховується індивідуально після аналізу вашої архітектури.

Розробка API: REST, GraphQL, WebSocket, tRPC

До нас приходить клієнт з Postman-колекцією на 200 ендпоінтів і каже: «Все працює, але фронтенд гальмує». Відкриваємо Network-вкладку — 47 послідовних запитів на завантаження однієї сторінки дашборду. Кожен чекає попереднього. Це не проблема швидкості сервера — це проблема архітектури API. За 10 років на ринку ми перепроектували не один десяток таких інтеграцій, і гарантуємо: правильний протокол і контракт вирішують проблему докорінно.

Коли REST перестає справлятися

REST добре працює для простих CRUD-операцій. Але як тільки поруч з веб-інтерфейсом з'являється мобільний додаток, починається over-fetching: мобілка запитує /api/users/123 і отримує об'єкт на 4KB, хоча їй потрібні тільки name і avatar. Помножте на список з 50 користувачів — 200KB трафіку замість 8KB.

GraphQL вирішує це через selection sets. Клієнт описує саме ті поля, які йому потрібні, і сервер повертає саме їх. На проекті з React Native + Next.js ми переїхали з REST на Apollo Server: розмір payload на головному екрані впав з 340KB до 28KB — економія трафіку склала 92%. Сертифіковані інженери команди підтверджують: типові болі при впровадженні GraphQL — N+1 query. Резолвер для поля author у поста викликає SELECT * FROM users WHERE id = ? для кожного поста у списку. На сторінці з 20 постами — 21 запит до бази. Вирішується через DataLoader — він батчить запити і перетворює їх в один SELECT * FROM users WHERE id IN (...).

Що таке tRPC і чим він кращий за REST/GraphQL?

Якщо весь стек на TypeScript (Next.js + Node/Bun), tRPC прибирає цілий шар проблем. Ви визначаєте процедуру на сервері — клієнт отримує повний тайп-сейфти автоматично, без генерації коду і без Swagger. Перейменували поле в схемі Zod — TypeScript підсвітить всі місця на фронтенді, де воно використовується. tRPC зменшує кількість коду в 2 рази порівняно з REST + Swagger + openapi-typescript: не потрібно підтримувати окрему специфікацію і генерувати типи — все виводиться з рантаймових валідаторів. Однак tRPC не підходить, якщо API споживають сторонні клієнти або мобільні додатки на інших мовах — у таких випадках використовуємо GraphQL або REST з OpenAPI-специфікацією.

WebSocket і реальний час: коли SSE, коли WS?

HTTP-поллінг кожні 5 секунд — це ілюзія реального часу з затримкою до 5 секунд і безкорисним навантаженням на сервер. Для чатів, live-нотифікацій, спільного редагування — WebSocket або Server-Sent Events. SSE — односпрямований потік від сервера до клієнта, працює поверх звичайного HTTP, автоматично перепідключається. Підходить для нотифікацій, стрімінгу даних, прогрес-барів. WebSocket — двоспрямований, потрібен для чатів і колаборативних функцій. Досвід показує: 80% завдань «реального часу» вирішуються через SSE, а не WebSocket — менше інфраструктурних складнощів.

Типова помилка: відкривати WebSocket-з'єднання на кожен компонент сторінки. На одному проекті дашборд відкривав 12 паралельних WS-з'єднань. Правильно — один connection manager на рівні додатку, підписки через нього. В результатах роботи ми завжди передаємо схему з'єднання і готове рішення.

Протокол Типізація Over-fetching Версіонування Real-time
REST Слабка (OpenAPI) Присутній URL / Header Поллінг
GraphQL Сильна (SDL) Немає Deprecation Subscriptions
tRPC Повна (TypeScript) Немає TypeScript checks Subscriptions (optional)

Swagger / OpenAPI як контракт

Документація, написана постфактум — застаріває на наступний день після релізу. Ми пишемо специфікацію OpenAPI 3.1 до початку розробки, вона стає контрактом між фронтендом і бекендом. Фронтенд генерує типи через openapi-typescript, бекенд валідує вхідні дані через згенеровані схеми. Розбіжність контракту з реалізацією ловиться на CI, а не на рев'ю. Для Laravel — l5-swagger або dedoc/scramble. Для Node.js — @fastify/swagger або Zod + zod-to-openapi.

Як правильно аутентифікувати API?

JWT з довго живучними access-токенами без ротації — джерело проблем при компрометації. Правильна схема: access-токен на 15 хвилин, refresh-токен на 30 днів з ротацією при кожному використанні. Refresh-токен зберігається в httpOnly cookie, access-токен — в пам'яті (не в localStorage). Для міжсервісної взаємодії — API Keys з scope-обмеженнями або mTLS. OAuth 2.0 з PKCE для публічних клієнтів (SPA, мобілки).

Версіонування і зворотна сумісність

Ламаючі зміни в API без версіонування ламають клієнтів. Три підходи ми використовуємо в проектах:

Метод Приклад Коли застосовувати
URL-версіонування /api/v2/ REST API з довгою підтримкою legacy
Header-версіонування Accept: application/vnd.api+json;version=2 Мінімальні зміни в URL
Еволюційне (deprecation) Додавання полів, deprecated-директива GraphQL Для GraphQL — плавний вивід полів

Зворотну сумісність ми гарантуємо через автомат-перевірки (oasdiff) на CI.

Як ми розробляємо API: покроковий план

  1. Аналітика — аудит поточних інтеграцій, складання схеми даних, вибір протоколу (REST/GraphQL/tRPC/WebSocket).
  2. Проектування контракту — OpenAPI або SDL (GraphQL) до першого рядка коду.
  3. Розробка — реалізація за контрактом, модульні тести на кожен ендпоінт.
  4. Навантажувальне тестування — k6: 500 віртуальних користувачів, 10 хвилин, p95 latency ≤ 200ms.
  5. Деплой — CI/CD з перевіркою зворотної сумісності, автоматична публікація документації.
  6. Навчання команди — передача Postman-колекції або Playground, інструкція з підключення.
Типові помилки, які ми виключаємо
  • N+1 при запитах без DataLoader.
  • Відсутність rate limiting — DDOS через неавторизовані ендпоінти.
  • Зберігання access-токена в localStorage.
  • Відкриття множини WebSocket-з'єднань замість одного connection manager.
  • Документація, не оновлена після релізу.

Що входить в роботу (deliverables)

  • OpenAPI 3.1 специфікація (або SDL для GraphQL).
  • Згенеровані клієнтські типи для TypeScript / Dart / Kotlin.
  • Набір автотестів з покриттям всіх ендпоінтів (модульні + інтеграційні).
  • Навантажувальні тести (k6) і звіт (p50/p95/p99 latency, RPS).
  • Документація в Swagger UI / Redoc / GraphiQL.
  • Навчання команди (2–4 години воркшопу).
  • Підтримка протягом 30 днів після здачі (за договором).

Наш досвід

  • 10+ років на ринку розробки API.
  • 200+ завершених проектів (REST, GraphQL, WebSocket, tRPC).
  • 50+ сертифікованих інженерів (AWS, Kubernetes, API Design).
  • Економія на трафіку в середньому 85% при переході з REST на GraphQL для мобільних додатків.
  • 100% зворотна сумісність — жодного зламаного клієнта за останні 3 роки.

Терміни

Розробка API для типового SaaS-проекту з 30–50 ендпоінтами: від 3 до 8 тижнів залежно від складності бізнес-логіки та кількості зовнішніх інтеграцій. Міграція існуючого REST API на GraphQL — від 2 до 6 тижнів. Додавання WebSocket-шару до готового бекенду — від 1 до 3 тижнів. Вартість розраховується індивідуально після аудиту. Отримайте консультацію — зв'яжіться з нами, щоб обговорити ваш проект.