Основы REST API WordPress — Crocoblock

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

Оглавление

Что такое API и как они работают?

Начнем с разъяснения, что такое API. Это означает Интерфейс прикладного программирования, который представляет собой набор принципов и правил, который позволяет одной программе или программному компоненту взаимодействовать с другим посредством запросов (также известных как команды) и ответов. «Приложениеозначает что-то цифровое, выполняющее конкретную задачу, а «Интерфейс» предназначен для общения.

Они в основном используются для клиент-серверная связь.

API простыми словами

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

Все мы знаем, что, приветствуя человека, мы не поворачиваемся к нему спиной, а поворачиваемся к нему, верно? Мы машем, пожимаем руки или кланяемся. Когда мы ездим на машине, есть некоторое понимание полос движения (забудем некоторые страны, где люди обладают особыми талантами и не нуждаются в них 😏). И все мы точно знаем, что если мы подойдем к человеку и ударим его по лицу, это не будет хорошим началом разговора.

Я только что привел самые примитивные примеры того, что можно назвать «универсальным кодексом поведения». Но в каждой стране свои коды: в Великобритании левостороннее движение; в Японии вместо рукопожатия кланяются и т. д.

Все эти наборы правил — это своего рода API, и их цель — чтобы помочь нам эффективно взаимодействоватьизбегать недопонимания и добиваться цели, точно так же, как REST API или API WordPress (которые предназначены для того, чтобы сделать WordPress надежным).

Не забывайте, что языки программирования – это, прежде всего, языкичто означает, что их основная роль — общение, поэтому сообщение, передаваемое выражением или строкой кода, должно быть правильно интерпретировано.

Когда кто-то приглашает нас на встречу Zoom, мы можем добавить это событие одним щелчком мыши (или полностью автоматически) в Календарь Google. Потому что они хорошо общаются, и это один из примеров отличной «командной работы» API.

API-протоколы

Как я уже упоминал, точно так же, как в разных странах может быть свой собственный кодекс правил, могут быть разные API для взаимодействия приложений. И самым популярным и эффективным является ОТДЫХ API, и вот мы здесь. Но сначала позвольте мне сказать несколько слов о других API.

Итак, если вы и ваш друг хотите иметь набор секретных знаков, намекающих на то, что вы закончили вечеринку (но других людей не следует обижать), почему бы и нет? Большим компаниям или разработчикам SaaS также нравится ситуация, когда никто посторонний не знает, что они отправляют через Интернет и как их программное обеспечение работает и взаимодействует. Вот почему Внутренний (только для компании), Партнеры (компания и ее друзья), и Композитный (некоторые виды смешанных) API существуют.

Но самая интересная для нас категория сейчас — это Открыть и Публичные API. Они просто хотят, чтобы вы говорили на их языке, и рады предоставить некоторую документацию. Об этой категории мы и поговорим. RESTful API является наиболее популярным и часто используемым среди них.

Некоторые альтернативы REST API

О REST API мы поговорим дальше, поэтому упомянем и о других протоколах и архитектурах. У них есть свои плюсы и минусы, а также конкретные варианты использования. Наиболее популярными являются:

• МЫЛО – он использует XML и немного более тяжел и сложен, чем REST.
• Вебсокеты – используется для приложений, требующих обновлений в реальном времени, таких как чаты или онлайн-игры.
• gRPC – известен своей производительностью и масштабируемостью, разработан Google и используется в основном для микросервисов.

Конечные точки API

API используют конечные точки. Конечные точки — это URL-адреса, уникальные адреса для определенных ресурсов или операций в API. Они используются с HTTP-глаголами (или методами запроса) для управления данными из этих конечных точек. Примеры таких глаголов:: GET, POST, PUT, DELETE и т. д., они используются для получения данных с сервера, загрузки данных на сервер, их изменения или удаления. Когда вы вводите любой URL-адрес в адресную строку браузера, в большинстве случаев вы запускаете запрос GET, ваш браузер действует как клиент, а сервер отправляет ему все запрошенные вами данные.

Пример запроса API (метод+конечная точка):

GET https://api.example.com/users

В этом примере он отправляет запрос о пользователях, и сервер возвращает нам список пользователей. Конечно, в реальной жизни конечные точки могут быть более конкретными и возвращать что-то более конкретное.

Что такое REST API?

Из всех различных API он имеет множество преимуществ, таких как гибкость, простота, масштабируемость, кэширование и другие преимущества. ОТДЫХ API означает «Изобразительное State Transfer», и у него есть набор ключевых принципов или ограничений, определяющих его архитектуру. Он был создан в 2000 году, так что это довольно молодой и амбициозный проект.

6 принципов REST API

Эти руководящие принципы на самом деле объясняют, почему REST API так популярен:

1. Клиент-сервер. Приложения REST следуют архитектуре клиент-сервер, где сервер управляет данными и состоянием приложения, а клиент обрабатывает взаимодействие с пользователем. Такое четкое разделение задач позволяет осуществлять независимые обновления и улучшения каждого компонента.
2. Лицо без гражданства. Серверы не поддерживают состояние клиента, а клиенты сами управляют состоянием своего приложения. Вся информация, необходимая для обработки запросов, включается в запросы клиента к серверу.
3. Кэшируемый. Сервер должен помечать свои ответы как кэшируемые и некэшируемые. Это позволяет системам и клиентам кэшировать ответы для повышения производительности и удалять некэшируемую информацию, чтобы избежать использования устаревших данных.
4. Единый интерфейс. Самая известная особенность REST — акцент на единообразном интерфейсе между компонентами. Таким образом, URL-адреса и URI имеют стандартизированную структуру.
5. Многоуровневая система. Компоненты системы ограничены соответствующими уровнями и не могут видеть за их пределами. Это делает их иерархическими и приводит к повышению безопасности и производительности.
6. Код по запросу (необязательно). Как правило, сервер отправляет клиенту предварительно реализованный код, но он также может отправлять его в виде скриптов или апплетов, поэтому клиент будет обращаться с ним по-своему.

WordPress REST API и варианты использования

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

REST API стал основой для Редактор блокови это один из самых многообещающих способов использования REST, поскольку он дает возможность не использовать PHP при разработке тем, а пойти другим путем и даже повысить производительность.

Если вы хотите проверить, как ваш сайт выглядит глазами REST API, просто добавьте к базовому URL /wp-json/wp/v2/posts/ чтобы получить что-то вроде https://mysite.com/wp-json/wp/v2/posts/. И вы увидите сообщения вашего сайта.

Давайте посмотрим на несколько примеров использования REST API в WordPress:

• Распространение контента из WordPress на разные платформы: мобильные или десктопные приложения, сторонние сервисы и так далее.
• Обмен данными между двумя сайтами WordPress.
• Создание пользовательского интерфейса с использованием любимых технологий JS.
• Создание headless CMS и создание статических сайтов.

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

Функция REST API JetEngine

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

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

Часто задаваемые вопросы

Заключение

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