Документация InstantCMS

для администраторов и разработчиков

Инструменты пользователя

Инструменты сайта


manual:components:api:methods:content-update_item

content.update_item.CTYPE

Редактирует одну запись для заданного типа контента. Метод аналогичен методу добавления записи.

Механизм добавления аналогичен механизму работы формы на самом сайте. В приложении нужно:

  1. Получить данные полей типа контента;
  2. При необходимости получить свойства;
  3. Сформировать форму в приложении;
  4. Данные с этой формы отправить на этот метод, дополнительно передав явные параметры метода, описанные ниже.

Обратите внимание, в HTML полях, в полях изображений, вы должны сами загружать изображения, пользуясь методом images.upload.

Метод требует авторизации пользователя.

Явные параметры

Название Описание
id ID обновляемой записи. Параметр необязательный.
to_draft 1 — сохранять в черновики. Флаг, может принимать значения 1 или 0. Параметр необязательный.
sig Параметр привязан к ip адресу клиента и к домену сайта. Это обязательный параметр.
csrf_token Параметр привязан к текущей сессии пользователя. Это обязательный параметр.

CTYPE в названии метода - это имя типа контента, например news, board и т.п. Параметры sig и csrf_token можно получиться как в ответах от методов получения данных формы, так и при помощи метода users.get_sig.

Пример

instantcms_site.ru/api/method/content.update_item.news?api_key=API_KEY&sig=SIG&csrf_token=CSRF_TOKEN&title=MyBestTtitle&other_fields=other_values

Результат

После успешного выполнения возвращает объект, содержащий текст успешного добавления в поле success_text и ID созданной записи в поле item_id.

Коды ошибок

В ходе выполнения могут произойти как общие ошибки, так и ошибки формы с кодом 100 и описанием их в request_params.


Назад к описанию методов API

manual/components/api/methods/content-update_item.txt · Последнее изменение: 13.09.2018 10:02 — fuze