У цьому туторіалі розглянемо API Joomla 4 та доступ до статей Joomla 4.
Стаття містить приклади кодування (з використанням PHP і CURL) для легкого налаштування. Для отримання додаткової інформації відвідайте детальну документацію по API Joomla 4.
Не забудьте замінити {{base_path}}
на вашу інсталяційну адресу Joomla 4 без кінцевої косої риски.
Доступ до всіх статей Joomla
Спробуємо отримати список всіх статей за допомогою API, це насправді досить просто, все, що вам потрібно зробити, це зробити GET запит на наступний URL нижче і включити ваше ім’я користувача та пароль супер-адміністратора Joomla в облікові дані, і ви отримаєте всі статті Joomla вашого сайту.
Запит
Тип запиту: GET
{{base_path}}/api/index.php/v1/content/article
Відповідь є стандартним json, і ви можете виконати json_decode, щоб отримати доступ до відповіді як до об’єкта. Відповідь підтримує пагінацію, тому якщо у вас є велика кількість статей на вашому сайті joomla, ви зможете досить легко орієнтуватися в API та отримати доступ до всіх статей, не перевищуючи ліміти вашого сервера.
Доступ до однієї статті
Тепер, коли у нас є список статей, ми можемо отримати доступ лише до однієї статті через API на основі ідентифікатора статті.
Запит
Тип запиту: GET
Замініть {{article_id}}
на ID статті, до якої ви хочете отримати доступ.
{{base_path}}/api/index.php/v1/content/article/{{article_id}}
У відповіді ви отримаєте API-посилання на статтю, а також дату створення статті, ідентифікатор категорії, теги, статус публікації та опис.
Створення нової статті
API Joomla 4 також дозволяє створювати статті, в цьому прикладі ми спробуємо створити одну з них.
Запит
Тип запиту: POST
Оскільки ми створюємо статтю, нам потрібно надати інформацію про статтю, яку ми хочемо створити, включаючи, але не обмежуючись, alias (має бути унікальним), aritlcetext, introtext (має містити або introtext, або articletext), catid, language (обов’язково) (за налаштуванням *), metadesc (обов’язково, за налаштуванням порожньо), metakey (обов’язково, за налаштуванням порожньо) та title (обов’язково).
За налаштуванням, новостворені статті знаходяться у неопублікованому стані.
{{base_path}}/api/index.php/v1/content/article
Ви отримаєте відповідь, подібну до відповіді попереднього запиту, де ми намагалися отримати доступ до статті за ID через API.
Видалення статті
Ми також можемо видалити статтю(-і) через API.
Запит
Запит на видалення онлайн вимагає ідентифікатор статті (як і запит на видалення окремої статті вище).
{{base_path}}/api/index.php/v1/content/article/{{article_id}}
Запит на видалення повертає не відповідь, а HTTP 204, що означає «все гаразд, але немає вмісту».