API и вебхуки

Через API внешняя программа (1С, сайт, своя система) может читать операции, справочники, отчёты и заявки и создавать заявки на оплату. Вебхуки, наоборот, сами сообщают программе о событиях в Aynes: новая операция, изменился статус заявки, не удалась синхронизация. API и вебхуки доступны на тарифе «Группа»; настраивают их владелец и администратор.

Полное описание запросов для программиста — на странице Описание API.

Выпустить токен

1. 1Откройте Настройки → Токены API.
2. 2Впишите название (например, «1С: выгрузка операций»), отметьте, Что разрешено токену — только то, что нужно программе, — и при желании срок действия. Нажмите Выпустить токен.
3. 3Скопируйте секрет кнопкой Скопировать и передайте программисту. Секрет показывается один раз: если потеряли — выпустите новый токен.

4. 4Токен перестал быть нужен или мог утечь — нажмите Отозвать: запросы с ним получат отказ сразу.

Токен действует, пока тот, кто его выпустил, — владелец или администратор организации. Если этот человек ушёл, выпустите токен заново.

Вебхуки

5. 5Откройте Настройки → Вебхуки и нажмите Создать подписку: адрес (https), на который слать уведомления, и события, о которых сообщать.
6. 6Скопируйте Секрет подписи — по нему программа проверяет, что уведомление пришло от Aynes. В Последних доставках видно, что ушло и дошло ли.

Для систем бронирования отдельный токен не нужен: у них свой ключ в Настройках броней (см. Брони).