API

KodiCMS предоставляет возможность программными средствами получать и записывать данные через REST API.

Что такое REST API

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

REST API предназначено, в основном, для запросов с внешних серверов, но также со временем внутренние запросы частично мигрируют на API.

Как использовать API

Все вызовы методов API — это GET, POST, PUT, DELETE HTTP-запросы к URL http://.../api/... с некоторым набором параметров.

В документации представлен список доступных методов. Например pages.get -> http://.../api/pages.get.

В ответ на запрос вы получаете его результат, который также описан в документации каждой функции.

Параметры запроса

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

Порядок следования параметров в запросе значения не имеет, порядок параметров важен только при расчете подписи.

Ответ от сервера

Все ответы приходят в формате JSON и содержат один обязательный параметр code, который содержит статус текущего ответа:

• 200 - Запрос успешно выполнен
• 110 - Отсутствует обязательный параметр
• 120 - Ошибка валидации данных (POST и PUT запрос)
• 220 - Отсутсвуют права на доступ к данным
• 404 - Метод API не найден

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