content.add_item.CTYPE
Добавляет запись в заданный тип контента. Механизм добавления аналогичен механизму работы формы на самом сайте. В приложении нужно:
- Получить данные полей типа контента;
- При необходимости получить свойства;
- Сформировать форму в приложении;
- Данные с этой формы отправить на этот метод, дополнительно передав явные параметры метода, описанные ниже.
Обратите внимание, в HTML полях, в полях изображений, вы должны сами загружать изображения, пользуясь методом images.upload.
Метод требует авторизации пользователя.
Явные параметры
| Название | Описание |
|---|---|
| to_draft | 1 — сохранять в черновики. Флаг, может принимать значения 1 или 0. Параметр необязательный. |
| sig | Параметр привязан к ip адресу клиента и к домену сайта. Это обязательный параметр. |
| csrf_token | Параметр привязан к текущей сессии пользователя. Это обязательный параметр. |
CTYPE в названии метода - это имя типа контента, например news, board и т.п. Параметры sig и csrf_token можно получиться как в ответах от методов получения данных формы, так и при помощи метода users.get_sig.
Пример
instantcms_site.ru/api/method/content.add_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