1 адрес на все справочники: /api/v1/lists/…. Через него внешняя программа читает и пишет данные сайта по HTTP.
В Wacis справочник — это не отдельная сущность API с собственным роутом. Статьи, товары, заявки и любые другие справочники работают по одной схеме.
Нужный справочник выбирается номером в адресе:
/api/v1/lists/{id}/records/
Так API не приходится переписывать, когда владелец сайта заводит новый справочник. Появился новый раздел с данными — у него есть id, поля и записи. Внешний скрипт продолжает работать с теми же методами.
Что доступно по HTTP:
GET — список справочников, поля, записи и одна запись.
POST — создать запись.
PATCH или PUT — изменить только присланные поля.
DELETE — удалить запись.
Сами справочники и их поля через API не создаются и не удаляются. Это изменение схемы базы, поэтому оно остаётся в панели.
Минимальный старт такой:
завести ключ в Настройки → Ключи API;
узнать id справочника в панели или через GET /api/v1/lists/;
слать запросы с Authorization: Bearer <ключ>.
Важная мелочь: завершающий слеш обязателен. Без него сервер делает редирект. Для GET обычно без разницы, а PATCH и DELETE могут повториться как GET и без тела. В итоге запрос «прошёл», но запись не изменилась.
Если подключаете склад, 1С, мобильное приложение или свой скрипт выгрузки — начинайте с перечня справочников и их полей. Так интеграция не завязывается на названия в админке.
#Wacis #API #CMS #ВебРазработка
Просмотры: 2