Обновить
64K+

Проектирование API *

О создании API

20,48
Рейтинг
Сначала показывать
Порог рейтинга
Уровень сложности
Формат публикации

Дружим OAuth и PDP

Уровень сложностиСредний
Время чтения12 мин
Охват и читатели12K

(Это автоперевод моей статьи OAuth meets PDP, v1.1)

В этой статье разбирается как можно выразить OAuth-скоупы и разрешения, используя политики авторизации в стандартных сервисах авторизации доступа (PDP).

Читать далее

От MCP Server до MCP Apps: как встроить своё приложение в AI

Уровень сложностиСредний
Время чтения9 мин
Охват и читатели4.9K

MCP позволяет предоставлять AI-клиентам доступ к возможностям существующих приложений, а MCP Apps дополняет эту интеграцию интерактивными интерфейсами.

В статье разберем, как эти технологии работают вместе, на примере интеграции с ChatGPT. Посмотрим реализацию React-галереи, в которой можно просматривать, скачивать и удалять изображения прямо в диалоге.

Также рассмотрим архитектуру, взаимодействие компонентов и ограничения подхода, чтобы было проще оценить возможности применения MCP Apps в собственных проектах.

Читать далее

Click SHOP API: подпись, Prepare и Complete, и ночная сверка, которая ловит «оплачено, а заказа нет»

Уровень сложностиСредний
Время чтения6 мин
Охват и читатели10K

В первой части был Payme: шесть методов JSON-RPC, четыре состояния и песочница, которая повторяет каждый запрос. У Click всё устроено иначе: два шага вместо шести, подпись MD5 вместо Basic Auth, сумма в сумах вместо тийинов и, что важнее всего, другой ответ на повтор. Если писать обе интеграции по одному шаблону, одна из них сломается.

А в конце — то, что не входит ни в один протокол, но без чего я бы не запускал приём платежей: ночная сверка.

Читать далее

Payme Merchant API: песочница шлёт каждый запрос дважды, и это лучший тест вашей интеграции

Уровень сложностиСредний
Время чтения6 мин
Охват и читатели9.5K

В песочнице Payme есть правило, которое легко пропустить при чтении документации: запросы CreateTransaction, PerformTransaction и CancelTransaction она посылает дважды, и ответ на второй должен совпасть с ответом на первый. Интеграция, написанная «по шагам», на этом и падает. Чаще всего из-за одной строки: perform_time: Date.now(), которая на повторе возвращает уже другое время.

Песочница не придирается. Она проверяет ровно то, что потом случится в бою: ответ потерялся по дороге, Payme Business отправил тот же запрос ещё раз и ждёт, что вы ответите так же, как в первый раз.

Дальше — как я строю обработчик Merchant API, чтобы повтор любого запроса был безопасен. Код на TypeScript и PostgreSQL, но от языка тут почти ничего не зависит.

Читать далее

От «добавьте проверку баланса» к требованиям: разбираем одну задачу

Уровень сложностиПростой
Время чтения11 мин
Охват и читатели6.7K

Заказ отправлен. Прошло три дня — он всё ещё «отправлен». Где посылка и почему поддержка знает больше, чем сайт? На простом примере разберём, как системный аналитик помогает решить эту задачу, зачем нужен API и что программы передают друг другу в запросах и ответах. Со схемами и без технического тумана.

Узнать, что будет дальше

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

Уровень сложностиСредний
Время чтения4 мин
Охват и читатели7.9K

В StudyNinja каждая задача знает, какой навык она тренирует. Платформа была готова принимать этот навык и учитывать его везде, где нужно. А потом мы заглянули в данные и увидели, что поле с навыком пустое во всех 1782 попытках учеников на тестовом стенде.

Причин нашлось три, и каждой хватило бы одной. Запрос к графу знаний проходил через навык, но не мог вернуть его наружу. Граф отдавал пустую строку вместо честного «значения нет». А платформа искала навык не в том месте ответа, где он лежал. Когда починили все три, всплыло четвёртое звено.

Самое неприятное в другом. Ничего не падало и не ругалось. Всё, что опиралось на навыки, тихо считалось по темам и выглядело исправным.

Полный разбор с кодом и чек-листом для тех, кто строит похожие системы

Читать далее

Все запросы вернули 200 OK, а записи пропали. Как пагинация незаметно теряет данные

Уровень сложностиПростой
Время чтения7 мин
Охват и читатели6.4K

API отвечает 200 OK, скрипт завершается без ошибок, а часть данных так и не попадает в базу. Разберём, как обычная пагинация может незаметно терять и дублировать записи, воспроизведём проблему на Python и посмотрим, как её обнаружить.

Читать далее

Эволюция API в эпоху AI: REST vs MCP на примере платёжного сервиса

Уровень сложностиСредний
Время чтения6 мин
Охват и читатели7.2K

Привет, Хабр! Меня зовут Рома, я backend-разработчик в ЮMoney. Почти 10 лет наша команда занимается в том числе развитием публичного платежного API. Недавно мы запустили MCP-сервер (Model Context Protocol), который позволяет нейросетям (LLM) напрямую работать с платежами и счетами.

В процессе разработки и отладки мы быстро поняли, что проектирование API для языковых моделей кардинально отличается от привычной REST-архитектуры. В этой статье я хочу поделиться полученным опытом и мыслями. Технических деталей создания MCP-сервера здесь не будет: их в интернете и так хватает. Статья будет интересна разработчикам и архитекторам, которые планируют создавать публичные или внутренние MCP-серверы.

Читать далее

Как среднему и крупному бизнесу выстроить мультимодельные AI-пайплайны через один ключ

Время чтения6 мин
Охват и читатели5.5K

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

Читать далее

OpenAPI спецификация как инструмент frontend-разработчика: практическое применение и типичные проблемы

Уровень сложностиСредний
Время чтения20 мин
Охват и читатели5.6K

OpenAPI — это не только Swagger UI с описанием ручек. Спецификация может стать основой для множества повседневных задач фронтенд-разработчика:

Генерации TypeScript-типов для RTK Query, React Query и нативного fetch.

Генерации API-клиентов на примере orval.

Типизации запросов и ответов в BFF на Express.

Валидации запросов в обработчиках Express.

Генерации моковых данных и запуска mock-сервера.

Но что делать, если исходная спецификация содержит ошибки и всё это перестаёт работать? Здесь пригодятся валидация и подготовка спецификации — покажу, как хранить необходимые исправления в виде воспроизводимых правил с помощью openapi-modifier.

Читать далее

Готов ли российский e-com и финтех к ИИ-агентам? Обзор 424 рыночных продуктов

Уровень сложностиПростой
Время чтения6 мин
Охват и читатели6K

Подключить ИИ-агента к магазину еще не значит, что удастся поручить ему покупку. Я изучила открытые документации 424 компаний и продуктовв E-com и Финтех РФ.

У 232 нашлись API, MCP или A2A, но большинство подключений рассчитаны на бизнес и юр.лиц, а не на персональное использование. Разбираю, что доступно личным агентам и какие ограничения мешают. Прилагаю карту сервисов и таблицу с источниками.

Читать далее

Как мы разработали публичный API для Авито Рекламы: микросервисы, обратная совместимость и контроль нагрузки

Время чтения6 мин
Охват и читатели5.5K

Привет! Я Андрей Безруков, ведущий продакт-менеджер в Авито Рекламе. Мы с командой разработали публичный API, чтобы рекламные агентства и профессиональные рекламодатели могли автоматизировать работу с Авито Рекламой. В статье расскажу, как выбирали архитектуру, тестировали систему и упрощали подключение пользователей.

Читать далее

Описываем граф одним классом: извлечение связей без N+1

Уровень сложностиПростой
Время чтения9 мин
Охват и читатели8.4K

Пусть НЕ простят меня администраторы БД и архитекторы, если случайно прочитают... Сегодня я расскажу про внутреннюю архитектуру JMatrixPlatform, в которой реализовано эффективное извлечение сложных многоуровневых графов, больших объёмов.

Читать далее

Ближайшие события

Корпоративный мультибанкинг на Открытых API: от выписки до оплаты

Время чтения11 мин
Охват и читатели8.6K

Представим компанию со счетами в трёх банках. В один приходят платежи покупателей, через другой проходит зарплата, в третьем лежит часть свободных денег. Счета поставщиков и будущие расходы находятся в учётной системе.

В пятницу финансовому директору нужно решить, что оплатить сегодня и сколько оставить на следующую неделю. Для этого недостаточно сложить остатки. Нужно учесть зарплату, проверить ожидаемые поступления и разобраться с уже отправленными платежами. Затем бухгалтер подготовит поручения, передаст их на подпись и сверит исполнение с учётом.

Меня в Open Banking (открытом банкинге) интересует возможность собрать эту работу в одном сервисе. Клиенту нужен ответ на вполне конкретный вопрос: можем ли мы провести эти платежи и что произойдёт после подтверждения?

Моя гипотеза — привычным местом работы с несколькими банками может стать сервис, в котором компания готовит платежи, согласует их и проверяет исполнение. Его может развивать банк, разработчик учётной системы или независимая компания. Попробую разобраться, что для этого дают общие API банков и какую работу всё равно придётся делать отдельно.

Читать далее

Проверка позиций сайта через API: три месяца я снимал «Яндекс», а отвечал Google

Уровень сложностиСредний
Время чтения6 мин
Охват и читатели6.4K

Я снимаю позиции статей, которые выходят не на моём сайте, а на чужих площадках: в отраслевых медиа, блогах, сообществах. Вебмастер и Search Console тут не помогают, они показывают позиции только по домену, который ты подтвердил как свой. Поэтому проверка позиций сайта у меня устроена по-простому: платный API отдаёт органическую выдачу по запросу, скрипт ищет в ней URL статьи и пишет место в базу.

Три месяца, с 7 июля по 13 октября 2026 года, скрипт исправно работал, и за это время в базе накопилось 42 477 строк замеров, и в отчётах они назывались «позиции сайта в Яндексе». 13 октября оказалось, что все они сняты с Google.

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

Один символ в адресе

У провайдера выдачи два адреса с одинаковым форматом ответа:

Читать далее

В API Grok внедрят невидимый водяной знак

Время чтения2 мин
Охват и читатели6.8K

В ответы моделей Grok в API внедрят невидимый водяной знак с 7 ноября. SpaceXSI сообщила об этом в документации для разработчиков.

Читать далее

Как я забираю чеки из личного кабинета ОФД: Selenium, идемпотентность и разбор JSON

Уровень сложностиСредний
Время чтения7 мин
Охват и читатели4.6K

Есть тип задач, который выглядит как «нажми кнопку и скачай файл», а на деле упирается в три вещи: кабинет не отдаёт данные за нужный период целиком, позиции чеков лежат отдельно от шапок, а выгружать надо не разово, а каждую неделю. В статье — как это устроено у меня изнутри, с кодом и с тем, что ломалось.

Читать далее

LLm агент в КОМПАС-3D: собрал редуктор, сделал КД, споткнулся на спецификации

Уровень сложностиПростой
Время чтения8 мин
Охват и читатели10K

Меня всегда интересовало инженерное 3D-моделирование, но руки так и не дошли освоить его в должной степени. Зато я весьма неплохо научился работать с ИИ-агентами. Поэтому было решено перенести весь этот опыт в плоскость инженерных задач.Так появился плагин, через который LLM-агент работает в КОМПАС-3D: открывает модели, строит и правит детали и сборки, оформляет чертежи.

В статье — один сквозной пример от расчёта до комплекта КД + как это устроено (без глубокого погружения), цифры на реальных задачах и честный список того, где агент пока ошибается.

Читать далее

Почему Idempotency‑Key не спасает от двойного списания и как это исправить

Уровень сложностиСредний
Время чтения9 мин
Охват и читатели7.3K

Клиент отправил платёж, не дождался ответа и повторил запрос. На сервере предусмотрен Idempotency-Key, тесты проходят, но деньги всё равно списываются дважды. Проблема возникает, когда второй запрос приходит до завершения первого: оба обработчика успевают проверить ключ и запустить оплату.

Разберём, как закрыть эту гонку с помощью PostgreSQL, что делать при падении процесса и почему даже правильно реализованная идемпотентность внутри сервиса не всегда спасает от повторного списания.

Разобрать решение
1
23 ...