Phenquestions
Зачем ИСПОЛЬЗОВАТЬ REST API:
В традиционных веб-приложениях, скажем, на простом веб-сервере PHP,
- Вы запрашиваете страницу (скажем, php) с сервера.
- Сервер находит файл сценария (php) в соответствии с запрошенной страницей и начинает ее выполнение. Скрипт подключается к базе данных, ищет необходимую информацию, размещает информацию на странице в красиво отформатированном виде (смешивая HTML + CSS + JavaScript с данными), что выглядит очень привлекательно для посетителя.
- Затем сервер отправляет его посетителю.
В этой модели вся обработка выполняется на стороне сервера. Значит, серверу нужно больше работать. Здесь данные не отделены от страницы, они глубоко встроены в страницу.
Если в будущем вы захотите создать приложение для Android, iOS или настольное приложение для своего веб-сайта, вам придется проделать гораздо больше работы. Вам нужно будет подключиться к базе данных напрямую из каждого из этих приложений, что может быть не очень безопасно. Время разработки увеличится, и возникнут проблемы с переносимостью.
Допустим, вы успешно создали приложения для ПК, Android и iOS для своего веб-сайта. В каждом из них полное имя пользователя отображается строчными буквами. Теперь вы хотите показать это в верхнем регистре. Что ж, разработчики должны изменить версию вашего приложения для ПК, Android и iOS отдельно, чтобы сделать это. Это отнимает много времени. В реальном мире все будет не так просто, как этот. Итак, одна версия приложения (скажем, версия для ПК) может иметь серьезную ошибку в процессе обновления. На то, чтобы исправить это позже, потребуется больше времени. Вы видите, как увеличивается время разработки? Это решение тоже не переносимо.
В REST API вы запрашиваете у сервера API, что вам нужно, и он отправляет вам только ту информацию, которую вы запрашиваете, дополнительное форматирование на сервере не выполняется. Нет необходимости в ненужной обработке на сервере. Таким образом, производительность вашего веб-сайта и приложений естественным образом улучшается. Кроме того, вы можете использовать одни и те же данные на своем веб-сайте, в настольном приложении, приложениях для Android и iOS. Изменения, внесенные на серверы, будут отражены в приложениях, использующих API. Время и стоимость разработки приложения также будут сокращены.
Как работает REST API:
У REST API есть конечные точки. Конечная точка - это не что иное, как URL-адрес, но красиво отформатированный и значимый. Он использует собственные HTTP-запросы (например, ПОЛУЧАТЬ, ПОЧТА, СТАВИТЬ, УДАЛИТЬ и т. д.), чтобы решить, что делать при доступе к каждой конечной точке. Я расскажу об этом позже.
Формат вывода REST API - JSON, также известный как JavaScript Object Notation.
Пример вывода ПОЛУЧАТЬ запрос к REST API на / пользователи / id / 12 конечная точка может выглядеть следующим образом:
"id": 12,
"name": "Дэвид Смит",
«возраст»: 42,
"телефоны": ["124-211-2341", "889-211-4545"],
"страна": "США"
Как видите, я сделал ПОЛУЧАТЬ запрос на / пользователи / id / 12 конечная точка, чтобы сообщить REST API, чтобы он предоставил мне информацию о пользователе, у которого есть я бы 12. Я получил только ту информацию, которую просил, не больше и не меньше.
Теперь предположим, что вам нужна информация о последних 10 пользователях, которые зарегистрировались на вашем сайте. Вы можете сделать ПОЛУЧАТЬ запрос на / users / latest / 10 конечная точка.
Вы также можете добавить новые данные на свой сервер с помощью REST API. Обычно HTTP ПОЧТА запрос используется, чтобы попросить REST API добавить новые данные на сервер API.
Например, вы можете сделать ПОЧТА запрос на / пользователи конечная точка с данными нового пользователя, и она будет добавлена в базу данных на вашем сервере API. Вы также можете настроить свой API так, чтобы он возвращал статус запроса.
"statusCode": 400,
"statusText": "Пользователь успешно добавлен.",
"данные":
"id": 13,
"name": "Мэри Смит",
«возраст»: 35,
"телефоны": ["124-211-2341", "889-211-4545"],
"страна": "США"
Как видите, statusCode а также statusText свойство объекта JSON уведомляет клиент API об успешном добавлении пользователя. Добавленные данные также возвращаются в данные свойство объекта JSON. Вы можете настроить свой API так, как хотите.
Вы также можете обновить существующую запись из базы данных сервера API. В СТАВИТЬ HTTP-запрос используется в конечной точке API для обновления существующих данных в базе данных вашего сервера API.
Например, предположим, вы хотите обновить номер телефона пользователя с идентификатором 13. Вы можете сделать СТАВИТЬ запрос к конечной точке API / пользователь / идентификатор / 13.
"statusCode": 200,
"statusText": "Пользователь обновлен.",
"old_data":
"id": 13,
"name": "Мэри Смит",
«возраст»: 35,
"телефоны": ["124-211-2341", "889-211-4545"],
"страна": "США"
,
"new_data":
"id": 13,
"name": "Мэри Смит",
«возраст»: 35,
"телефоны": ["100-211-1111", "140-211-1145"],
"страна": "США"
Как видите, операция обновления прошла успешно. Старые данные и новые данные возвращаются в old_data а также new_data свойство объекта JSON соответственно.
Вы также можете удалить данные из базы данных сервера API с помощью HTTP УДАЛИТЬ запрос к конечной точке API.
Например, чтобы удалить пользователя с идентификатором 12, вы можете выполнить УДАЛИТЬ запрос к конечной точке API / пользователь / идентификатор / 12.
"statusCode": 150,
"statusText": "Пользователь удален.",
"данные":
"id": 12,
"name": "Дэвид Смит",
«возраст»: 42,
"телефоны": ["124-211-2341", "889-211-4545"],
"страна": "США"
Как видите, пользователь удален, а данные удаленного пользователя возвращаются в данные свойство объекта JSON.
Я объяснил стандартный способ использования ПОЛУЧАТЬ, ПОЧТА, СТАВИТЬ а также УДАЛИТЬ HTTP-запрос на конечных точках API для выполнения операции CRUD (создание, чтение, обновление и удаление) с использованием REST API. Но вы можете настроить свой API для выполнения определенных действий по определенному HTTP-запросу. Здесь ничего не исправлено. Например, вы можете обновить API, используя ПОЛУЧАТЬ HTTP-запрос. Вам не нужно использовать СТАВИТЬ. Это зависит от разработчика API.
Вы также разрабатываете конечные точки API. Присвоение значимых имен конечным точкам API значительно упрощает использование REST API.
Приложения REST API:
API-интерфейсы делают разработку приложений более простой и модульной. С помощью REST API вы можете легко переносить свое приложение на разные платформы.
Все, что вам нужно сделать, это спроектировать и разработать REST API вашего приложения. Затем вы можете использовать свой REST API со своего веб-сайта, приложения для Android, приложения для iOS, настольного приложения для Windows, приложения для Linux и т. Д. Таким образом, все ваши приложения на разных платформах будут использовать одну и ту же логику, а время и затраты на разработку сократятся. Приложениями также будет проще управлять. API-интерфейсы REST в наши дни также быстро используются в одностраничных веб-приложениях.
Я написал статью о написании REST API с использованием Python. Спасибо, что прочитали эту статью.
