Обновить
21.58

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

О создании API

Сначала показывать
Порог рейтинга
Уровень сложности

Умный поиск по API, или NLP против функционального поиска

Уровень сложностиПростой
Время на прочтение5 мин
Количество просмотров1.5K

Всем привет! Это Игорь Густомясов, CTO кластера техноплатформы в МТС, и Никита Бояндин, ведущий разработчик в том же кластере. (Да, мы создали текст вместе.) Рассказываем о поиске данных API для Интеграционной платформы МТС.

Наш коллега Александр Бардаш круто расписал, как мы развиваем функции Интеграционной платформы. Так вот: получилось настолько хорошо, что возникла проблема.

В экосистеме МТС множество продуктов — от проката самокатов до высокотехнологичных сервисов The Platform. Стоило интеграционной платформе встать на ноги, как на ней резко выросло количество спецификаций API.

Так перед нами развернулась двойная задача: не только технически поддержать различные протоколы взаимодействия (HTTPS, gRPC, GraphQL и прочие), но и сделать поиск данных API. Решение — под катом.

Читать далее

Как мы с ChatGPT спецификацию OpenAPI писали: опыт системного аналитика

Уровень сложностиПростой
Время на прочтение12 мин
Количество просмотров3.6K

Приветствую, коллеги! Я ведущий системный аналитик в компании ЛАНИТ. В своей статье я решила поделиться этапами совершенствования процесса описания интеграционного взаимодействия на отдельно взятом проекте нашей компании и рассказать, как благодаря использованию генеративной модели ChatGPT мы ускорили процесс формирования документации OpenAPI и частично снизили связанные с этим трудозатраты системных аналитиков.

Статья может быть полезна системным аналитикам и командам, проектирующим API по принципу Design API First (Contract first). Материал основан на реальном опыте системных аналитиков нашего проекта и не является руководством или призывом к действию.

Читать далее

Поиск ликвидных облигаций с использованием Python

Уровень сложностиПростой
Время на прочтение5 мин
Количество просмотров16K

На Московской бирже торгуется более 2500 облигаций, но большая часть из них неликвидна - в стакане почти нет предложений и сделок совершается крайне мало. Это затрудняет покупку и продажу таких бумаг. При этом известные мне публичные сервисы не суммируют объемы торгов за период, поэтому сложно быстро найти облигации с высокой ликвидностью.

Пять лет назад написал Node.js-скрипт, затем адаптировал его для Google Таблиц, а теперь разрабатываю Python версию. При помощи сообщества на GitHub эта Python версия идёт к созданию полноценной библиотеки с расширенными возможностями: автоматический поиск ликвидных облигаций, расчет денежных потоков, сбор новостей по эмитентам и вычисление оптимального объема покупки. Все это направлено на помощь простым инвесторам, вроде нас с вами, чтобы оперативно находить выгодные инвестиционные инструменты и принимать решения на основе актуальной информации.

Проект полностью open source.

Автоматизация работы с облигациями

GraphQL или REST: Какой API выбрать, чтобы не прогадать?

Уровень сложностиПростой
Время на прочтение3 мин
Количество просмотров3.8K

Привет, хабровчане!

Я Дима, Backend-разработчик на Go.

Расскажу о GraphQL, сравню с REST. Разберемся в плюсах и минусах каждого подхода к проектированию API. Выбираем лучший для вашего проекта!

Читать далее

Авто-генерация типизированных API контроллеров на клиенте из Swagger

Уровень сложностиСредний
Время на прочтение9 мин
Количество просмотров3K

Зачастую нам приходится описывать API-запросы или переписывать уже имеющиеся ввиду изменения каких-то DTO (Data Transfer Object) или параметров у запросов. Это вполне естественно для разработки, но часто оказывается скучным и однотипным процессом, не требующим размышлений или особых навыков. В этой статье я рассказываю, как автоматизировать всю эту историю.

Читать далее

Как настроить уведомления из систем документооборота (СЭД) с помощью API

Уровень сложностиПростой
Время на прочтение10 мин
Количество просмотров749

Системы электронного документооборота (СЭД) отлично справляются со своей задачей, избавляя вас от расходов на бумагу, упрощая управление документами и сокращая время на согласования. Минус у них один, но серьезный: их эффективность полностью зависит от того, как быстро пользователь узнает о любых изменениях. Пропущенное уведомление о новых документах, согласованиях или дедлайнах способно дезорганизовать любой бизнес-процесс.

Эту задачу можно решить. API-интеграция с использованием Exolve API, автоматизирует отправку уведомлений через SMS, email или мессенджеры. Это исключает задержки, снижает риски ошибок и повышает надежность системы. Осталось понять, как это можно сделать, чем мы и займемся в нашей статье.

Читать далее

Парсинг с помощью LLM: зачем, как и сколько стоит?

Уровень сложностиСредний
Время на прочтение13 мин
Количество просмотров20K

Во всю идет 2025 год, и нейросети перестают быть чем‑то фантастическим. Они уже повсюду в нашей жизни: от умных колонок в квартирах до сложнейших систем, управляющих логистикой и финансами. Вместе с ними стремительно меняется подход к работе с данными. В этой статье мы поговорим о том, как современные LLM помогают автоматизировать сбор данных с веб‑сайтов и сводят к минимуму рутинную настройку и «подкручивание» парсеров.

Что еще вы найдете в этой статье?

Читать далее

BPMS с интеграцией 1С: ЗУП и ЭП сократила планирование отпусков в госорганизации до 3 дней

Время на прочтение4 мин
Количество просмотров1.1K

Всем привет! Продолжаю рассказывать об автоматизации HR‑процессов для госсектора. В учреждении с более чем 2 тыс. сотрудников ежегодное планирование отпусков стало серьезной операционной проблемой. Отдел кадров тратил около 160 рабочих часов в год на администрирование процесса. В течение года сотрудники часто меняли планы, каждый перенос требовал ручной обработки.

Требовалось оцифровать процесс планирования отпусков и завершить переход организации на КЭДО.

Читать далее

Мой опыт создания регистрации: @AuthenticationalPrinciple, JWT, UserDetails

Уровень сложностиСредний
Время на прочтение9 мин
Количество просмотров5.9K

Казалось бы, что может быть проще создания регистрации и логика: взял пароль, взял username, сохранил в базу, когда пользователь заходит, просто сравниваешь значения с теми, что лежат в базе.

А потом кто-то взламывает доступ к твоей базе и продает строчку за рубль. А если у тебя еще и приложение, где у пользователя есть информация о банковском счете, а у тебя пароли лежат незашифрованные в базе.

Сегодня я покажу как решить эту проблему.

Читать далее

Как отправлять критические уведомления из промышленных SCADA-систем по SMS API

Уровень сложностиПростой
Время на прочтение7 мин
Количество просмотров1.1K

SCADA-системы — это программно-аппаратные комплексы для мониторинга и управления промышленными процессами. При сбоях и авариях они формируют критические уведомления о перегревах, утечках, отказах оборудования и других опасных ситуациях. 

Отправлять такие оповещения в Telegram значит их гарантированно потерять. Поэтому мы решили сделать интеграцию с Exolve API для их автоматической отправки для мгновенного оповещения ответственных специалистов через SMS.

Читать далее

Оптимизация работы с REST API: когда и как использовать пагинацию (+ простой пример на Python)

Уровень сложностиПростой
Время на прочтение14 мин
Количество просмотров9.9K

Итак, пользователи вашего приложения уже жалуются на долгую загрузку данных, а серверы едва справляются с нагрузкой. Одна из возможных (и частых) причин в том, что API пытается выгрузить тысячи записей за один запрос. Без пагинации базы данных захлебываются под тяжестью SELECT-запросов, а клиенты уходят к конкурентам, не дождавшись ответа.

Почему пагинация — это не опция, а must-have для любого API? Как избежать типичных ошибок при ее внедрении? И почему даже стартапам с небольшим трафиком стоит задуматься о ней уже сегодня? Ответы — в разборе принципов, которые превращают пагинацию из технической детали в инструмент роста бизнеса.
Читать дальше →

Глава 8: Реализация API. API-интерфейсы для самых маленьких

Уровень сложностиПростой
Время на прочтение16 мин
Количество просмотров6.2K

Структура мини-курса Мини-курс API-интерфейсы для самых маленьких.

Вы сделали это. Теперь вы знаете все, что нужно знать об API, по крайней мере, на вводном уровне. Итак, как вы можете использовать все эти приобретенные знания с пользой? В этой главе мы рассмотрим, как превратить знания в работающее программное обеспечение, выделив три основополагающих компонента любой реализации API, как AI и платформы для автоматизации бизнес-процессов и интеграции приложений могут повысить эфективность вашего труда.

Читать далее

Глава 7: Взаимодействие с API в режиме реального времени. API-интерфейсы для самых маленьких

Уровень сложностиПростой
Время на прочтение9 мин
Количество просмотров6.1K

В Главе 6 мы узнали о проектировании API, создавая свои собственные. На данный момент у нас есть много с трудом заработанных знаний, и пришло время, чтобы они начали приносить пользу. Мы готовы увидеть, как мы можем заставить API работать на нас. В этой главе мы узнаем четыре способа достижения коммуникации в реальном времени через API.

Читать далее

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

Глава 6: Проектирование API

Уровень сложностиПростой
Время на прочтение10 мин
Количество просмотров11K

Структура мини-курса Мини-курс API-интерфейсы для самых маленьких.

Глава 6 знаменует собой поворотный момент в нашем приключении с API. Мы закончили рассматривать основы и теперь готовы увидеть, как предыдущие концепции объединяются, чтобы сформировать API. В этой главе мы обсудим компоненты API, проектируя его.

Читать далее

Глава 5: API-аутентификация, часть 2 (OAuth)

Уровень сложностиПростой
Время на прочтение7 мин
Количество просмотров9.9K

В Главе 4 мы упомянули, что большинство веб-сайтов используют имя пользователя и пароль для аутентификации учетных данных. Мы также обсудили, что повторное использование этих учетных данных для доступа к API небезопасно, поэтому API часто требуют другой набор учетных данных, нежели те, которые используются для входа на веб-сайт. Распространенным примером являются ключи API. В этой главе мы рассмотрим другое решение — открытую авторизацию (OAuth), которая становится наиболее широко используемой схемой аутентификации в Интернете.

Читать далее

Глава 4: API-аутентификация, часть 1 (базовая и ключевая)

Уровень сложностиПростой
Время на прочтение5 мин
Количество просмотров12K

В нашем понимании API все начинает проясняться. Мы знаем, кто такие клиент и сервер, мы знаем, что они используют HTTP для общения друг с другом, и мы знаем, что они используют в определенные форматы данных, чтобы понимать друг друга. Однако знание того, как общаться, оставляет важный вопрос: как сервер узнает, что клиент — тот, за кого себя выдает? В этой главе мы рассмотрим два способа, которыми клиент может доказать свою идентичность серверу.

Читать далее

Глава 3: Типы и форматы API

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

Глава 3: Типы и форматы API

До сих пор мы узнали, что HTTP (протокол передачи гипертекста) (Hyper-Text Transfer Protocol) является основой API в сети и что для их использования нам нужно знать, как работает HTTP. В этой главе мы рассмотрим данные, предоставляемые API, как они форматируются и как HTTP делает это возможным.

Читать далее

Как я научил
 буфер обмена думать

Уровень сложностиПростой
Время на прочтение5 мин
Количество просмотров16K

Я научил буфер обмена думать, и теперь всё вокруг стало быстрее. А что если выделенный текст мгновенно станет грамотным, переведётся на нужный язык или расшифрует картинку? Одно нажатие — и ИИ исправляет ошибки в Telegram, объясняет код в VS Code или переводит иностранные мемы.

Читать далее

Глава 2: API-протоколы. Мини-курс API-интерфейсы для самых маленьких

Уровень сложностиПростой
Время на прочтение14 мин
Количество просмотров21K

В главе 1 мы разобрались что такое API, и составили представление о двух сторонах, задействованных в API: сервере и клиенте. Разобравшись с тем, кто это делает, мы готовы глубже изучить, как эти две стороны взаимодействуют. В контексте мы сначала рассмотрим человеческую модель общения и сравним ее с компьютерной. После этого мы перейдем к особенностям общего протокола, используемого в API.
В главе 2 мы больше узнаем про протоколы

Структура мини-курса Мини-курс API-интерфейсы для самых маленьких.

Читать далее

Очередное решение для разработки API и не только

Уровень сложностиСредний
Время на прочтение10 мин
Количество просмотров2.3K

Возможно, вы не слышали о Sunrise экосистеме, так или иначе, сегодня я поделюсь опытом разработки API, используя Sunrise решения и не только.

Читать далее

Вклад авторов