1. Пример из реального мира
2. Что такое ОТДЫХ?
3. Что может использовать REST API?
4. API REST в реальном мире
5. Что подразумевается под термином «RESTful API»?
6. Пример Dropbox API для файловых операций
7. «RESTful» клиент-серверная архитектура
8. Веб-службы RESTful (API)
9. Популярные форматы запросов REST API
10. Популярные форматы ответов REST API
11. Нужен ли ключ API для доступа к API REST?
12. Так это API REST или просто API?

Быстрый пост, объясняющий, что такое REST API и как его можно использовать. Я явно не делаю предположений о том, что вы знаете, и это очень краткое объяснение может быть очень сложной темой.

REST API определяет набор функций, которые разработчики могут выполнять запросы и получать ответы по протоколу HTTP, такие как GET и POST.

Поскольку REST API использует HTTP, они могут использоваться практически любым языком программирования и легко тестироваться ( для REST API требуется, чтобы клиент и сервер были независимы друг от друга, что позволяло либо кодироваться на любом языке, но и улучшать поддержку долголетия и эволюция).

Всемирная паутина (WWW) является примером распределенной системы, использующей архитектуру протокола REST для предоставления гипермедиа-управляемого интерфейса для веб-сайтов. Я называю гипермедиа (вместо гипертекста) термином расширения, чтобы избежать путаницы в том, что REST API поддерживает другие форматы, а не только HTML.

Пример из реального мира

Twitter предоставляет REST API, который вы можете запрашивать для получения последних твитов, вы можете предоставить поисковый запрос (или хэш-тег), и он будет возвращать результаты в формате JSON. Пример этого HTTP-запроса к API Twitter, чтобы получить последние 3 твита, соответствующие «jQuery». Попытайся ,

http://search.twitter.com/search.json?q=jQuery&result_type=recent&rpp=3

И чтобы расширить возможности REST API:

API REST должен указывать, что он может предоставить и как его использовать, такие сведения, как параметры запроса, формат ответа, ограничения запроса, ключи общего пользования / ключи API, метод (GET / POST / PUT / DELETE), поддержка языка, использование обратного вызова, Поддержка HTTPS и представление ресурсов должны быть самоописательными ...

Это информация, предоставленная для ПОЛУЧИТЬ поиск / твиты REST API.

Посмотреть демо

Что такое ОТДЫХ?

REST означает Изобразительное State Transfer который по существу относится к стилю веб-архитектуры, которая имеет множество базовых характеристик и управляет поведением клиентов и серверов.

Что может использовать REST API?

REST API позволяет вам взаимодействовать с Parse из всего, что может отправить HTTP-запрос. Увидеть Parse REST Definition для примеров этого.

API REST в реальном мире

Добро пожаловать большие мальчики.

Что подразумевается под термином «RESTful API»?

Соответствие ограничениям REST обычно называется «RESTful»

API можно считать «RESTful», если он имеет следующие функции (не полный список только основные)

1. Клиент-сервер - клиент обрабатывает внешний интерфейс, а сервер - внутренний и может быть заменен независимо друг от друга.
2. Без сохранения состояния - данные клиента не сохраняются на сервере между запросами, а состояние сеанса сохраняется на клиенте.
3. Кэшируемый - клиенты могут кэшировать ответы (так же, как браузеры кешируют статические элементы веб-страницы) для повышения производительности.

Соответствие этим ограничениям и, следовательно, соответствие архитектурному стилю REST позволяет любому распределенной гипермедиа-системе обладать желаемыми эмерджентными свойствами, такими как производительность, масштабируемость, простота, модифицируемость, видимость, портативность и надежность. Обычная тенденция, которую я видел, состоит в использовании абсолютных URL для API RESTful, которые имеют смысл.

Пример Dropbox API для файловых операций

«RESTful» клиент-серверная архитектура

HTTP, например, имеет очень богатый словарный запас с точки зрения глаголов (или «методов»), URI, типов мультимедиа в Интернете, кодов запросов и ответов и т. Д. REST использует эти существующие функции протокола HTTP и, таким образом, позволяет существующему многоуровневому прокси и компоненты шлюза для выполнения дополнительных функций в сети, таких как HTTP-кэширование и обеспечение безопасности.

Веб-службы RESTful (API)

Веб-сервис RESTful (также называемый веб-API RESTful) - это веб-сервис, реализованный с использованием HTTP и принципов REST. Это набор ресурсов с четырьмя определенными аспектами:
базовый URI для веб-службы, такой как http://example.com/resources/

Интернет-тип данных, поддерживаемый веб-сервисом. Это часто XML, но это может быть любой другой допустимый тип мультимедиа в Интернете при условии, что это допустимый стандарт гипертекста.
набор операций, поддерживаемых веб-службой с использованием методов HTTP (например, GET, PUT, POST или DELETE).

Это набор ресурсов с четырьмя определенными аспектами:
базовый URI для веб-службы, такой как http://example.com/resources/
Интернет-тип данных, поддерживаемый веб-сервисом. Часто это JSON, XML или YAML, но это может быть любой другой допустимый тип интернет-медиа.
набор операций, поддерживаемых веб-службой с использованием методов HTTP (например, POST, GET, PUT или DELETE).
API должен быть управляемым гипертекстом. [11]

Популярные форматы запросов REST API

Также см: Основные различия между SOAP и REST API

Популярные форматы ответов REST API

Я работаю в основном с JSON, он кажется самым популярным для разработчиков jQuery, для очевидные причины ,

Нужен ли ключ API для доступа к API REST?

Большинство API имеют ограничение на количество запросов и могут попросить вас предоставить ключ API (который вы, возможно, создали с их помощью). API, чувствительные к данным, потребуют от вас аутентификации, и наиболее популярным методом является открытая аутентификация, также известная как oAuth. Я кратко коснулся этого раньше Как работает Twitter oAuth , Не буду вдаваться в oAuth здесь.

Например, Google Translate требует ваш ключ API в запросе GET.

https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&source=en&target=de&q=Hello%20world

Так это API REST или просто API?

Чтобы решить эту проблему, вам нужно заполнить документацию и определить, удовлетворяет ли API критерию, чтобы он был квалифицирован как RESTful. API Atom хороший пример того, который действительно квалифицирует его как RESTful.

Дальнейшее чтение

Похожие

Комментарии