INTERLAB
Как делать · 09

API и интеграции

REST и GraphQL, вебхуки, OAuth и OpenID Connect, платежи, Telegram, CRM, 1С и надёжность внешних API.

Прочитано: 0 / 10REST и GraphQLGraphQLВебхукиOAuth 2.0 и OpenID ConnectПлатёжные интеграцииTelegram-ботыИнтеграции с CRMИнтеграции с 1СВнешние API и обработка ошибокБезопасность интеграций

REST и GraphQL

  1. Сравнение✓

    REST или GraphQL

    REST отдаёт данные ресурсами с отдельными адресами, поэтому его ответы кэшируют браузер, CDN и прокси, а ошибки видны по HTTP-статусу. GraphQL принимает на один адрес запрос с перечнем нужных полей и собирает связанные данные за один круг по сети, но кэш переезжает на клиент, ошибки — в тело ответа, а сервер обязан ограничивать глубину и стоимость запросов. REST разумен для публичных API, интеграций и файлов, GraphQL — для нескольких клиентов с разными экранами над связанными данными.

    Средний · 12 мин чтения

GraphQL

  1. Пошаговый урок✓

    GraphQL: схема, запросы и мутации

    GraphQL-сервер состоит из схемы и резолверов. Схема на языке SDL описывает типы, точки входа Query и Mutation и аргументы, а резолверы — функции, которые возвращают значения полей из базы или других сервисов. Клиент отправляет POST /graphql с текстом операции и переменными и получает JSON той же формы. Чтобы сервер выдержал произвольные запросы, связи загружают пакетами через DataLoader, а глубину и стоимость запросов ограничивают до выполнения.

    Средний · 9 мин чтения · практика ~1,5–3 ч

Вебхуки

  1. Руководство✓

    Вебхуки: приём, подпись, повторы и идемпотентность

    Вебхук — HTTP-запрос, которым внешний сервис сам сообщает вашему серверу о событии: платёж прошёл, заказ изменился. Надёжный приёмник проверяет HMAC-подпись по сырому телу и метке времени, сохраняет событие по его id и сразу отвечает 2xx, а обрабатывает событие в фоне. Повторная доставка с тем же id не должна выполнить действие второй раз, а старое событие — перезаписать более новое состояние.

    Средний · 10 мин чтения · практика ~1–2 ч

OAuth 2.0 и OpenID Connect

  1. Глубокий разбор✓

    OAuth 2.0 и OpenID Connect: вход через чужой аккаунт

    OAuth 2.0 — протокол делегирования доступа: пользователь разрешает приложению действовать от его имени, не отдавая пароль, а приложение получает access token с ограниченным scope. OpenID Connect добавляет поверх него вход: ID token сообщает, кто вошёл, и его нужно проверить — iss, aud, exp, nonce и подпись. Основной поток сегодня — Authorization Code с PKCE; implicit и передача пароля через password grant по RFC 9700 не используются.

    Средний · 10 мин чтения

Платёжные интеграции

  1. Руководство✓

    Интеграция платежей: сценарий, статусы и вебхуки

    Надёжная онлайн-оплата у любого провайдера строится по одной схеме: сервер создаёт платёж с ключом идемпотентности, покупатель платит на странице провайдера, а заказ становится «оплаченным» только после подписанного вебхука и проверки статуса запросом к API. Статусы заказа задаёт машина состояний: повторное событие ничего не меняет, невозможный переход поднимает тревогу. Сверка по расписанию находит платежи, вебхук о которых потерялся.

    Средний · 10 мин чтения · практика ~2–4 ч

Telegram-боты

  1. Пошаговый урок✓

    Telegram-бот: Bot API, команды и вебхук

    Telegram-бот — это программа, которая получает обновления от серверов Telegram и отвечает вызовами Bot API по HTTPS с токеном от @BotFather. Обновления приходят либо через getUpdates (long polling — удобно при разработке), либо через вебхук на ваш HTTPS-адрес с проверкой заголовка secret_token. В уроке бот на Node.js 24 и grammY принимает заявку кнопками и пересылает её менеджеру, а проверяется тестами без реального токена.

    Начальный · 7 мин чтения · практика ~1,5–3 ч

Интеграции с CRM

  1. Руководство✓

    Интеграция с CRM: адаптер, маппинг полей, синхронизация

    Интеграцию сайта с CRM строят как адаптер за портом: ядро приложения передаёт заявку в своём формате, а адаптер переводит её в запросы конкретной CRM — в этом руководстве это amoCRM REST API v4. Надёжность дают четыре решения: маппинг полей по id из настроек аккаунта, поиск дублей по нормализованному телефону и email, журнал обмена с идемпотентным повтором и два канала синхронизации статусов — вебхуки и периодическая сверка.

    Средний · 10 мин чтения · практика ~1–2 ч

Интеграции с 1С

  1. Руководство✓

    1С для разработчика: HTTP-сервисы и OData

    У 1С:Предприятия два HTTP-входа для внешних систем. Стандартный интерфейс OData — автоматический REST по протоколу OData 3.0 ко всем включённым в его состав объектам: без программирования, но «широкий» и привязанный к структуре конфигурации. HTTP-сервисы — собственный REST, который программист 1С описывает в конфигурации: узкий контракт с бизнес-логикой внутри 1С. Чтение справочников удобно брать из OData, а заказы и операции с правилами — через HTTP-сервис по согласованному контракту.

    Средний · 10 мин чтения · практика ~1–2 ч

Внешние API и обработка ошибок

  1. Руководство✓

    Внешние API: таймауты, повторы, лимиты и деградация

    Каждый вызов чужого API нужно ограничить таймаутом на попытку и на всю операцию, повторять только временные сбои (сеть, таймаут, 408, 429, 5xx) и только для идемпотентных запросов, а паузы между попытками делать экспоненциальными со случайным разбросом (jitter) и с учётом заголовка Retry-After. Если сервис лежит долго, circuit breaker перестаёт его вызывать, а приложение отвечает из кэша или честной заглушкой, не роняя свои страницы.

    Средний · 10 мин чтения · практика ~1–2 ч

Безопасность интеграций

  1. Основы✓

    Безопасность интеграций: ключи, подписи, минимальные права

    Каждая интеграция — это новый вход в систему и новый ключ, который может утечь. Базовый набор защит: отдельный ключ с минимальными правами на каждую интеграцию и окружение, плановая ротация с перекрытием старого и нового ключа, проверка подписи, свежести и схемы каждого входящего события, запросы по чужим URL только после проверки адреса (SSRF) и журналы без токенов и персональных данных. Данные партнёра проверяются так же строго, как ввод пользователя.

    Средний · 9 мин чтения

Траектории с этим направлением

API и интеграции · 8 →← Все направления
Расскажите о задаче — мы изучим запрос и свяжемся с вами

Есть задача?
Обсудим и оценим — бесплатно.

Расскажите о продукте или проблеме. Предложим архитектуру, срок и стоимость первой версии после изучения задачи.

  • Оценка объёма и рисков до старта
  • NDA — по вашему или нашему шаблону
  • Старт работ в течение недели
Написать в WhatsApp

Не присылайте через форму пароли, ключи доступа и исходный код — безопасную передачу доступа обсудим отдельно.

Нажимая кнопку, вы соглашаетесь с обработкой персональных данных.