Возможно, вы слышали много шума о WordPress JSON REST API. Это большая новость для пользователей WordPress и повод для радости!

JSON, REST, API — это слишком много жаргона для одного названия, так что давайте разберем все по порядку.

Что такое API?

API означает «интерфейс прикладного программирования», который представляет собой набор инструкций и стандартов по программированию для доступа к программному веб-приложению или веб-инструменту. Представьте себе «программу номер один», которая дает инструкции «программе номер два». API — это соглашение между ними, и линии связи открыты. По сути, они говорят друг другу что-то вроде «когда вы дадите мне указание, я выполню действие или верну правильную информацию».

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

Примеры API

Доступ к API — это здорово, когда вы разрабатываете веб-приложения. Когда API публикуется, это означает, что разработчики создали решения, основанные на сервисе программного обеспечения. Часто они избавляют от необходимости изобретать велосипед для многих задач, поскольку они уже созданы.

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

Еще одним примером взаимодействия API может быть покупка билетов на концерты. Для официальной покупки билетов вам необходимо ввести данные вашей кредитной карты. API используется для отправки информации о вашей кредитной карте в удаленное приложение, которое затем проверяет правильность информации о кредитной карте. После того, как все проверено, удаленное приложение отправляет ответ обратно на веб-сайт билетов, говоря, что все в порядке, и в этот момент вы успешно приобрели билеты. Когда все это происходит, вы видите только один интерфейс — сайт билетов. Это бесшовный процесс; за кулисами многие приложения работают вместе с использованием API, но вы, как пользователь, не замечаете, когда задачи передаются из одного приложения в другое.

API и WordPress

Amazon и покупка билетов — отличные примеры совместной работы API, но как это применимо к WordPress?
Ну, все те же идеи применимы. С помощью WordPress API вы можете передавать и извлекать данные из WordPress.

API — это ключевой инструмент, который разработчики могут использовать для простого обмена данными со своего веб-сайта WordPress с другими веб-сайтами или приложениями. В частности, этот API позволяет выполнять действия по create , read , update и delete (CRUD) контента WordPress. Вот несколько примеров типов контента:

• Сообщения
• Пользовательские типы сообщений
• Страницы
• Таксономии
• Пользователи
• Средства массовой информации

Что означает ОТДЫХ?

Здесь нет дремоты или храпа, но REST относится к архитектурному стилю API. REST означает передачу репрезентативного состояния. Помните, как мы упомянули, что API дает специфику для связи, чтобы программы могли общаться друг с другом? API-интерфейсы REST разработаны таким образом, что они обеспечивают упрощенный метод связи, который экономит полосу пропускания. WordPress JSON REST API делает именно это, что делает его отличным вариантом при наличии большого объема данных.

Мы только что поцарапали поверхность REST; если вы хотите узнать больше, ознакомьтесь с этим полезным руководством по REST.

формат JSON

Чтобы получить доступ к данным, нам нужен источник для получения. Здесь на помощь приходит JSON. JSON расшифровывается как нотация объектов JavaScript. JSON легко читать и понимать как людям, так и машинам. Это идеальный способ хранения информации в упорядоченном и удобном для доступа виде. Поскольку доступ к JSON очень прост, он отлично подходит для создания REST API и является идеальным решением для WordPress JSON REST API.

Вот основная идея того, как выглядит формат JSON:

{"employees":[
	{"firstName":"Jane", "lastName":"Smith"},
	{"firstName":"Anna", "lastName":"Olsen"},
	{"firstName":"Josh", "lastName":"Jones"}
]}

Формат JSON в WordPress

JSON не просто пишет сам себя, но не волнуйтесь, вам не нужно вручную создавать файл JSON. Есть отличный плагин, который создает его для вас. С помощью этого инструмента данные сайта будут в правильном формате, включая пользователей, сообщения, страницы, таксономии и многое другое. Плагин можно найти здесь. Кроме того, есть некоторая полезная документация, которая будет полезна, когда вы начнете.

Использование JSON REST API

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

Получить или обновить данные так же просто, как отправить HTTP-запрос. HTTP — это протокол запроса/ответа. Сначала вы отправляете запрос данных, а затем данные отправляются обратно в качестве ответа.

ПОЛУЧИТЬ метод

Метод GET используется для получения информации и не влияет на данные. Просто отправьте запрос GET на /wp-json/wp/v2/posts . Хотите что-то искать? Например, если вы ищете «разработка», вы получите результаты с запросом GET /wp-json/wp/v2/posts?search=development .

POST-запрос

Для отправки данных используется POST-запрос. С возможностями нового API, например, вы можете обновить пользователя. Допустим, вы хотите обновить пользователя с идентификатором 10. Все, что вам нужно сделать, это отправить запрос POST на /wp-json/wp/v2/users/10 .

Чтобы попробовать это, я бы рекомендовал использовать Postman, расширение Google Chrome.

Больше Javascript в миксе

Backbone.js и API

Backbone.js — отличный способ работы с API, поскольку это фреймворк, предназначенный для работы с REST API. API WordPress включает простой в использовании API Javascript, основанный на моделях Backbone. Это позволяет разработчикам плагинов и тем начать работу без особых усилий и знаний о деталях подключения. Это еще не все, но Backbone структурирует веб-приложения, предоставляя модели, коллекции и представления, и подключает все это к WordPress API через интерфейс REST JSON.

Что все это значит для разработчиков WordPress?

С появлением WordPress API появилось больше новых способов его использования, и они будут продолжать расти по мере того, как он набирает популярность. API WordPress может улучшить практически любую существующую функциональность WordPress, основанную на Javascript. Вот несколько примеров:

• проверка/отправка формы
• Темы или плагины Backbone.js
• бесконечная прокрутка

Это также отличный способ показать контент из других источников. Теперь легко отображать контент с отдельного сайта в многосайтовой настройке. Также возможно отображать контент с совершенно отдельного сайта WordPress. Помимо отображения содержимого, его также можно обновлять.

Теперь, когда мы рассмотрели некоторые основные термины, мы знаем, что JSON — это нотация, REST — это архитектурный стиль, а API — это интерфейс, который они составляют. Знание основ API и его возможностей обеспечит вам хорошее начало при изучении новых возможностей API WordPress.