Гайды
Создание новости v200.1.0
Как создать новость через POST /post/ и править её через /table/post/.
Этот гайд — как добавить новость через API, будто нажали «Добавить» в админке. Список и фильтры — отдельно: Поиск новостей. Доп. поля — xfields-news.
Что нужно заранее
- Установка → Авторизация (Bearer)
- Scope write (и при правке — edit) на таблицу
post— уровни - Общая схема запросов — эндпоинты
Создать: POST /post/
curl -sS -X POST 'https://ВАШ_САЙТ/api/v2/post/' \
-H 'Authorization: Bearer <access_token>' \
-H 'Content-Type: application/json' \
-d '{
"title": "Заголовок",
"short_story": "Кратко",
"full_story": "Полный текст",
"category": "1,2",
"approve": 1
}'Ожидайте 201 и что-то вроде { "id": 42 }.
Полезные поля:
| Поле | Смысл |
|---|---|
title | Заголовок |
short_story / full_story | Анонс / полный текст |
category | ID категорий через запятую |
approve | 1 — опубликована, 0 — черновик |
xfields | Сырая строка доп. полей (удобнее через encode) |
post_extras, post_extras_cats, … | Вложенные связанные записи |
Проверить
GET /api/v2/post/42
Authorization: Bearer <access_token>В ответе sugar-эндпоинта часто уже разобраны category и xfields (raw + parsed).
Изменить или удалить
Sugar create не заменяет update/delete:
PUT /api/v2/table/post/42
Authorization: Bearer <access_token>
Content-Type: application/json
{ "title": "Новый заголовок", "approve": 1 }DELETE /api/v2/table/post/42
Authorization: Bearer <access_token>То же через SDK
На том же PHP-сайте без HTTP: SDK → DcApi::news()->withTitle(…)->create().