Введение в WordPress REST API

Опубликовано: 2017-01-13

Выпуск WordPress 4.7 вызвал большой ажиотаж в сообществе, и не без оснований. Помимо множества введенных улучшений и функций, настоящим хитом стало объявление об интеграции ядра REST API. Как мы упоминали в предыдущих сообщениях, это эффективно превращает WordPress из платформы для ведения блогов в систему управления контентом (CMS). Но как будет происходить эта трансформация? И какие будут преимущества для пользователей?

В этой статье мы сначала познакомим вас с некоторыми фундаментальными понятиями, а затем покажем, как вы можете начать экспериментировать с API и своим веб-сайтом.

Все веб-сайты наших клиентов уже обновлены до версии WordPress 4.7.1. Итак, начнем!

Что такое API?

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

Существуют API для разных уровней программного обеспечения, от операционной системы до Интернета.

Что такое REST API?

REST расшифровывается как REpresentational State Transfer и обеспечивает ту же совместимость и взаимодействие компонентов, но на более высоком уровне: в Интернете. С REST у вас может быть разнообразное веб-приложение, написанное на Python, Java или PHP, которое взаимодействует и обменивается данными друг с другом, даже если они размещены в разных системах. Поскольку каждая система знает, как «говорить» на REST, она может говорить со всеми, кто это делает!

REST использует протокол HTTP в качестве коммуникационного транспорта и стандартные HTTP-запросы для реализации своих основных операций. Эти операции называются глаголами. Наиболее часто используемые: PUT, GET, PATCH, DELETE. Эти глаголы воздействуют на то, что REST называет ресурсами. Они реализуются разработчиком программного обеспечения и эффективно реализуют все четыре основные компьютерные операции, работающие с хранилищем: создание, чтение, обновление, удаление ( CRUD ).

Разместите свой сайт с Pressidium

60- ДНЕВНАЯ ГАРАНТИЯ ВОЗВРАТА ДЕНЕГ

ПОСМОТРЕТЬ НАШИ ПЛАНЫ

Для представления данных и обмена ими REST использует упрощенную спецификацию данных, называемую JSON ( Javascript Object Notation ). Структура JSON очень проста. Его простота и легкость использования по сравнению с тысячестраничной спецификацией XML и др. обеспечили его немедленное принятие разработчиками, сделав его де-факто стандартом обмена данными в Интернете.

Как WordPress это реализует?

Итак, у нас есть концепция глаголов (Создать, Читать, Обновить, Удалить), действующих на Ресурсы. WordPress определяет как ресурс REST почти каждый отдельный элемент информации, который существует на платформе. От пользователей сайта до настроек, сообщений, таксономий сообщений, уведомлений, мультимедиа, статистики и всего, что между ними. Сюда входят операции, которые могут быть определены для этих ресурсов. Например, для комментариев определены следующие операции:

  • Получить список последних комментариев.
  • Получить список последних комментариев к сообщению.
  • Получите один комментарий.
  • Изменить комментарий.
  • Создание комментария к посту.
  • Создайте комментарий в качестве ответа на другой комментарий.
  • Удалить комментарий.
  • Получите лайки за комментарий.
  • Как комментарий.
  • Уберите лайк с комментария.
  • Получите статус лайка за комментарий.

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

Таким образом, WordPress становится платформой для разработки и CMS , рассматривая каждый бит данных, которые существуют на нем, как ресурс REST . Все они доступны через общедоступный стандартизированный API, позволяющий внешним сторонам выполнять над ними операции CRUD . Таким образом, WordPress открывается и становится совместимым с остальным миром программного обеспечения, будь то Java, Python или Ruby; и почти с каждым языком или системой, которая знает, как общаться с помощью REST.

Попробуй сам

Есть несколько способов, с помощью которых вы можете начать возиться с REST API вашего веб-сайта. Проще всего использовать плагин тестирования REST в вашем браузере. Их несколько, но самым популярным является Postman (доступен для MacOSX, Windows и Chrome).

Например, предположим, что вы хотите получить объект JSON, содержащий все записи нашего блога. Для этого вам сначала нужно обратиться к официальному справочнику WordPress REST, чтобы узнать базовый маршрут этого вызова запроса (это /wp/v2/posts ).

  Все, что нам нужно сделать сейчас, это следующее:

  1. Выберите ПОЛУЧИТЬ в раскрывающемся меню. Как видите, доступно множество глаголов REST, но рассмотрение их всех не входит в задачи этой статьи.
  2. Добавьте базовый маршрут (/ wp /v2/posts ) к корневому URL-адресу REST вашего веб-сайта (http://www.acme_shop_2.onpressidium.com/wp-json/), сформировав URL-адрес, который вы видите на экране.
  3. Нажмите кнопку Отправить .

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

Будущее WordPress яркое!

На протяжении многих лет WordPress сильно развивался и давал пользователям новые возможности. Для всех, начиная от отдельных блоггеров, журналистов, издателей и заканчивая владельцами бизнеса, а теперь и разработчиками программного обеспечения из других сообществ с открытым исходным кодом. WordPress продолжает расширять возможности своих пользователей. Он по-прежнему служит примером того, чего могут достичь люди, если ими движет одна и та же страсть, но из разных слоев общества. Его интеграция REST API с ядром WordPress не только открывает новый мир возможностей, но и создает новый мир сложности . Это то, чем на самом деле является наше управляемое решение для хостинга WordPress, это наш вклад в сообщество. Речь идет о предоставлении возможностей вам и вашему ежедневному предприятию . Речь идет о борьбе со всей этой сложностью, о том, чтобы все работало и гудело, и о том, чтобы быть рядом, когда что-то неизбежно сломается.