[Перевод] Возвращаем информативные ошибки API

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

https://habr.com/ru/companies/otus/articles/1018008/

#API_ошибки #обработка_ошибок #REST_API #HTTP_статускоды #проектирование_API #код_ошибки #сообщения_об_ошибках #валидация_данных #интеграции_API

REST API と GraphQL の違いをフロントエンド目線で整理する
https://qiita.com/ryo_sh/items/18a4ddd39ada54c58b12?utm_campaign=popular_items&utm_medium=feed&utm_source=popular_items

#qiita #フロントエンド #REST_API #GraphQL

Вебхуки в Битрикс24: автоматизация CRM без написания приложений

В Bitrix24 автоматизация часто превращается в отдельный проект: приложения, OAuth, лишняя инфраструктура. Хотя многие задачи — создание сделок, уведомления, реакции на события — можно закрыть намного проще. Вебхуки дают прямой доступ к API через один URL и позволяют быстро связать CRM с внешними сервисами. Разберёмся, как это работает, где реально помогает и где начинаются ограничения.

https://habr.com/ru/companies/otus/articles/1017116/

#вебхуки #Bitrix24 #REST_API #интеграция #CRM_автоматизация #inbound_webhook #outbound_webhook #бизнеспроцессы #batch_запросы #автоматизация_процессов

Как связать машинное зрение, WMS и конвейер: сортировочная линия на 41 направление

На распределительных складах одна из главных задач — сортировка грузов. Коробки нужно сгруппировать в нужной точке с учетом их массогабаритных характеристик и адреса назначения. На одном из таких складов запустили автоматическую линию сортировки на 41 направление. Производительность линии достигает 4000–5000 коробок в час. Но главная задача проекта заключалась не в автоматизации самого конвейера. Интегратору нужно было связать между собой три независимые системы: систему машинного зрения, складскую систему учета (WMS), систему управления конвейером. Кроме того, нужно было создать пользовательский интерфейс и организовать удаленный доступ к системе. В статье подробно разберем это решение.

https://habr.com/ru/companies/wirenboard/articles/1017126/

#Wiren_Board #IntraSCADA #Интралогистика #WMS #Siemens_S71200 #склад #складская_логистика #складской_учет #Profinet #rest_api

Design‑First в действии: API на Spring с OpenAPI Generator

Когда команда пишет API, но документация живёт своей жизнью, а интеграторы часами гадают, что значит ошибка 500, — проект неизбежно тонет в хаосе. В этой описан подход, который является лучшим решением: Design‑First на основе OpenAPI . Мы пройдём полный цикл: от проектирования спецификации до работающего Spring‑приложения с автоматической генерацией кода и централизованной обработкой ошибок. Вы узнаете, как одна команда ./gradlew clean build может создать модели и интерфейсы, избавив вас от рутины.

https://habr.com/ru/companies/otus/articles/1008384/

#api #openapi #spring #rest_api #swagger #spring_boot #designfirst #code_generation

Проектирование бесплатного API с пользовательскими данными: почему я отказался от jsonplaceholder

Я периодически провожу технические интервью и смотрю pet-проекты кандидатов. И почти всегда вижу одну и ту же картину: Используется localStorage или заглушки вроде jsonplaceholder. Я прекрасно понимаю, почему так происходит:

https://habr.com/ru/articles/1015906/

#api #rest_api #backend #nodejs #javascript #json #api_key #вебразработа

Как я тестирую API: чеклист и подходы, и автоматизация

Открыл Postman, потыкал эндпоинты, всё ответило 200 — вряд-ли хорошее тестирование Разбираю что на самом деле нужно проверять в API, показываю примеры на Postman и Jest, и даю чеклист который можно взять и использовать прямо сейчас.

https://habr.com/ru/articles/1015576/

#API_тестирование #Postman #Jest #QA #автотесты #REST_API #чеклист #тесткейсы #автоматизация_тестирования #axios

# 10 ошибок API

40 000+ записей без пагинации, 200 OK вместо 400 Bad Request, SQL-запросы в ответах клиенту. Собрал 10 ошибок API из реальных проектов: монолитов, микросервисов, стартапах и энтерпрайза.

https://habr.com/ru/articles/1013924/

#API #REST_API #HTTP #проектирование_API #backend #пагинация #версионирование #идемпотентность #HTTPстатусы #валидация

Avo 4 오픈 베타 출시: Rails 어드민 프레임워크의 대대적 진화

UI4 디자인 시스템을 도입하여 카드, 버튼, 컬러 피커 등 시각적 요소의 커스터마이징 자유도를 높이고 더욱 현대적인 인터페이스를 구축했다.

🔗 원문 보기

Микросервисы: как выбрать между синхронной блокировкой и событийной архитектурой?

Синхронные вызовы кажутся простыми и знакомыми, пока не превращаются в цепочки, которые рушат всю систему. Событийная архитектура выглядит элегантно, но таит подводные камни: что класть в событие? как быть с долгими операциями? В статье вы найдёте: ▫️ живые примеры из реальных аварий (включая историю с бесконечными ретраями в очереди), ▫️ три готовые диаграммы в формате Mermaid, которые можно сразу использовать в документации, ▫️ чёткий алгоритм выбора стиля под вашу задачу. Материал будет полезен архитекторам, ведущим разработчикам и всем, кто проектирует распределённые системы. Покажу, как не повторять ошибок, которые стоили компаниям миллионов.

https://habr.com/ru/companies/otus/articles/1008366/

#архитектура #микросервисы #асинхронность #синхронное_взаимодействие #событийная_архитектура #kafka #rest_api