TL; версия DR

В одном из предыдущих постов мы вкратце обсудили, каково использовать GitHub API v3. Эта версия предназначена для взаимодействия, как и любой другой REST API. Есть конечные точки для каждого ресурса, к которому вам нужно получить доступ и / или изменить. Есть конечные точки для каждого пользователя, каждой организации, каждого репозитория и т. Д. Например, у каждого пользователя есть конечная точка API по адресу https: // api.github.com / users / вы можете попробовать подставить свое имя пользователя вместо и введите URL-адрес в браузере, чтобы увидеть, что API отвечает.

GitHub API v4, с другой стороны, использует GraphQL, где QL означает язык запросов. GraphQL - это новый способ разработки ваших API. Точно так же, как существует множество веб-сервисов, предлагаемых как REST API, а не только тех, что предлагаются GitHub, существует множество веб-сервисов, которые позволяют взаимодействовать с ними через GraphQL.

Самая резкая разница между GraphQL и REST API, которую вы заметите, заключается в том, что GraphQL может работать без единой конечной точки API. В случае GitHub API v4 эта конечная точка - https: // api.github.com / graphql и все. Вам не нужно беспокоиться о добавлении длинных строк в конец корневого URI или предоставлении параметра строки запроса для дополнительной информации. Вы просто отправляете аргумент типа JSON этому API, запрашивая только то, что вам нужно, и вы получаете обратно полезную нагрузку JSON с той же самой информацией, которую вы запрашивали. Вам не нужно заниматься фильтрацией нежелательной информации или снижать производительность из-за больших ответов.

Что такое REST API?

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

Таким образом, сеанс между клиентом и сервером обычно не имеет состояния. После загрузки веб-страницы и связанных скриптов вы можете продолжать взаимодействовать с ними, и когда вы выполняете действие (например, нажимаете кнопку отправки), тогда отправляется запрос на отправку вместе со всей контекстной информацией, необходимой веб-серверу для обработки этого запроса ( например имя пользователя, токены и т. д.). Приложение переходит из одного состояния в другое, но без постоянной необходимости соединения между клиентом и сервером.

REST определяет набор ограничений между клиентом и сервером, и связь может происходить только при этих ограничениях. Например, REST через HTTP обычно использует модель CRUD, которая означает создание, чтение, обновление и удаление, а методы HTTP, такие как POST, GET, PUT и DELETE, помогают выполнять эти операции и только эти операции. Старые методы вторжения, такие как SQL-инъекции, невозможны с чем-то вроде четко написанного REST API (хотя REST не является панацеей безопасности).

Это также очень помогает разработчикам пользовательского интерфейса! Поскольку все, что вы получаете из HTTP-запроса, является типичным потоком текста (иногда в формате JSON), вы можете легко реализовать веб-страницу для браузеров или приложения (на предпочитаемом вами языке), не беспокоясь об архитектуре на стороне сервера. Вы читаете документацию по API для таких сервисов, как Reddit, Twitter или Facebook, и можете писать расширения для них или сторонних клиентов на выбранном вами языке, поскольку вам гарантируется, что поведение API останется прежним.

И наоборот, серверу все равно, написан ли интерфейс на Go, Ruby или Python. Будь то браузер, приложение или интерфейс командной строки. Он просто «видит» запрос и отвечает соответствующим образом.

Что такое GraphQL?

Как и все в мире компьютеров, REST API становились все больше и сложнее, и в то же время люди хотели реализовать и использовать их быстрее и проще. Вот почему Facebook придумал идею GraphQL, а позже открыл ее. QL в GraphQL означает язык запросов.

GraphQL позволяет клиентам делать очень конкретные запросы API, вместо того, чтобы делать жесткие вызовы API с предопределенными параметрами и ответами. Это намного проще, потому что сервер тогда отвечает точно теми данными, которые вы его запрашивали, без лишнего.

Взгляните на этот запрос REST и соответствующий ему ответ. Этот запрос предназначен для просмотра только общедоступной биографии пользователя.