REST API - Как сделать хорошо

preview_player
Показать описание
В этом видео я расскажу основные принципы при проектирование REST API, которых стоит придерживаться, чтобы ваше описание было понятным и удобным для использования. Первый шаг перед созданием отличной OpenAPI или Swagger спецификации.

00:00 Введение
01:33 Запрос / Request
07:55 Ответ / Response

#REST #API #tutorial #openapi #swagger #examples
  1. IT как Конструктор
  2. rest
  3. rest api
  4. api
  5. openapi
  6. swagger
Рекомендации по теме
Что такое API? 0:06:05

Что такое API?

Как сделать REST 0:05:48

Как сделать REST API лучше?

What is a 0:09:12

What is a REST API?

REST API - 0:13:42

REST API - Как сделать хорошо

Как сделать REST 1:23:20

Как сделать REST API на Symfony в PHP. Полный гайд для разработчиков backend...

Android Studio как 0:27:14

Android Studio как сделать REST API приложение, Retrofit2, GSON 2020 #1

КАК СДЕЛАТЬ РЕГИСТРАЦИЮ 0:07:48

КАК СДЕЛАТЬ РЕГИСТРАЦИЮ В СВОЕМ ПРИЛОЖЕНИИ? API НА PHP

Чем плох REST 0:44:17

Чем плох REST API и что с этим можно сделать

API vs. SDK: 0:09:21

API vs. SDK: What's the difference?

Create A REST 0:25:37

Create A REST API With JSON Server

Make your own 0:16:45

Make your own mock API (super simple)

Как сделать идеальное 0:15:01

Как сделать идеальное резюме и сопроводительное письмо...

DEV Labs 2014. 0:48:06

DEV Labs 2014. Как сделать публичное API.

Using REST APIs 0:09:21

Using REST APIs in a web application | Quick PHP Tutorial

What is an 0:03:25

What is an API?

Как Сделать Лучший 1:15:57

Как Сделать Лучший Пет-Проект | Архитектура Бекенда за 1 час...

Нельзя просто так 0:49:14

Нельзя просто так взять и сделать версионирование API. Игорь Кальницкий...

Запись выступления Андрея 0:48:06

Запись выступления Андрея Гордиенкова ' Как сделать публичное API '...

Изучение Android Studio 1:17:47

Изучение Android Studio за час в одном видео! Создание погодного приложения с API...

Константин Виноградов: Backend. 0:13:40

Константин Виноградов: Backend. Как сделать 20 интеграций за 20 минут...

REST Assured Beginner 0:06:38

REST Assured Beginner Tutorial 1 | Getting Started | What is Rest Assured

005. Как аналитику 0:20:20

005. Как аналитику сделать API для прода и не облажаться — Александр Кучин...

😱 Как сделать 0:08:35

😱 Как сделать ANDROID приложение за 10 минут! Сможет каждый :3...

Как создать JSON 0:09:14

Как создать JSON запрос и сделать фейковый сервер

Комментарии
Автор

Отличный материал. Для новичка супер!
Я бы ещё посоветовал сделать видео про модель данных. Связи. На примерах из реальных проектов. Потому что все в основном объясняют на библиотеках) книга автор и т.д.

vladzh
Автор

Дружище, спасибо большое за отличный материал! Очень доступно объясняешь)

petefedorov
Автор

errorCode мой случай) бизнес логика может содержать свои состояния. Например http может быть 200 но по бизнес логике запрос будет отклонен - не страшно. Но например по бизнес логике нужно передать успешный код в параметре errorCode. С точки зрения семантики может здесь лучше использовать например statusCode? Как правильно, поделитесь?

ДмитрийТарасевич-вц
Автор

Спасибо за видео. Коммент в поддержку!

sovrinfo
Автор

Получилось так что этот видеоролик посмотрел только сейчас. Ваш пример мне очень помог в понимании написания методов с телом запроса. Сам Swagger воспринял теперь мой "код описания" без каких-либо ошибок.

Но при попытке ввода новых значений после нажатия кнопки "Tty it out", в области "Code", возвращает не успешный код 200, а следующую ошибку:

TypeError: Failed to execute 'fetch' on 'Window': Failed to read the 'headers' property from 'RequestInit': String contains non ISO-8859-1 code point.

Как думаете, как можно привести описание в соответствие с этим стандартом ISO? Как понять что именно в описании не соответствует этом стандарту?

AntiGusar
Автор

Интересно что "Метод предназначен для получения уведомления со статусом выполнения переданного ранее запроса." реализован через post, логичнее вроде как по restful через get. Можете уточнить почему так?

richug
Автор

методом get ни изменять, ни удалять нельзя не потому что "вас не поймут" 🤦🤦🤦

hiddeninfogofwar
Автор

вы чо там у себя при создании сущности в ответ возвращаете 200 а не 201? лол кек чебурек

Zadr