Центр розробника — це місце, де ви підключаєте Exayard до власного коду та інструментів. Відкрийте його в розділі Settings, потім Developer. Тут ви створюєте ключі API, реєструєте кінцеві точки вебхуків і переглядаєте живий журнал кожного запиту до API. Лише адміністратори організації можуть отримати доступ до цієї сторінки.
Ключі API
Ключ API автентифікує запити до API Exayard. Ключі належать вашій організації, тож потрібний обліковий запис вибирається автоматично, і не потрібно передавати жодного ідентифікатора організації.
Відкрийте вкладку API keys у картці Credentials і натисніть кнопку +. Дайте ключу Name, потім оберіть його Scopes. Виберіть All, щоб надати кожну область доступу, або Specific, щоб обрати окремі дозволи. Області доступу мають поділ на читання та запис за ресурсом, як-от read:projects і write:estimates. Область admin:org — це грант повного доступу. Обирайте мінімальні області доступу, потрібні для вашої інтеграції.
Exayard показує повний ключ один раз, одразу після його створення. Скопіюйте його тоді, бо він більше ніколи не показується. Після цього кожен ключ відображається з його назвою, замаскованим попереднім переглядом на кшталт ak_••••1234 та датою останнього використання.
Використовуйте значок олівця, щоб перейменувати ключ або змінити його області доступу. Використовуйте значок кошика, щоб Revoke (відкликати) його. Відкликання остаточне, і будь-яка інтеграція, що використовує цей ключ, негайно перестає працювати.
Той самий ключ автентифікує інтеграції без коду. Див. Підключення Exayard до Zapier, Підключення Exayard до Make і Підключення Exayard до n8n. Для доступу агентів і ШІ-редакторів див. Підключення до Claude та інших інструментів ШІ.
Вебхуки
Вебхук наказує Exayard сповіщати ваш сервер, коли щось відбувається. Відкрийте вкладку Webhooks і натисніть +, щоб додати кінцеву точку. Введіть URL, який має отримувати доставки, та необов’язковий Description.
Оберіть, на які Events підписатися. Виберіть All, щоб отримувати кожну подію, або Specific, щоб обрати зі списку:
Подія | Спрацьовує, коли |
| Проєкт створено |
| Проєкт змінено |
| Проєкт архівовано |
| Оцінювання обміру починається |
| Оцінювання завершується |
| Оцінювання схвалено |
| Оцінювання скасовано |
| Кошторис згенеровано |
| Тендерну пропозицію згенеровано |
| Завантажений файл завершує обробку |
Коли ви створюєте кінцеву точку, Exayard показує secret для підпису один раз. Скопіюйте його тоді, бо він більше не показується.
Захист доставок вебхуків
Кожна доставка містить заголовок Exayard-Signature у форматі t=<unix>,v1=<digest>. Exayard будує підпис, об’єднуючи позначку часу та тіло запиту, потім підписуючи їх за допомогою HMAC-SHA256 із використанням secret вашої кінцевої точки.
Щоб перевірити доставку, повторно обчисліть підпис своїм secret, підтвердьте, що позначка часу в межах п’яти хвилин від поточного моменту, і порівняйте дайджести. Невдалі доставки повторюються з експоненційною затримкою протягом приблизно трьох днів.
Щоб відредагувати кінцеву точку, натисніть значок олівця. Ви можете змінити URL, опис і події та встановити її Status на Active чи Paused. Призупинені кінцеві точки перестають отримувати доставки. У тому самому діалозі є кнопка Rotate secret. Ротація випускає новий secret, а старий негайно перестає працювати, тож оновіть свій сервер, перш ніж виконувати ротацію. Значок кошика видаляє кінцеву точку та припиняє всі доставки до неї.
Швидкий старт
Картка Quick start містить готову підказку для ШІ-редактора на кшталт Claude чи Cursor. Натисніть Copy prompt і вставте її у свій редактор. Підказка включає базову URL-адресу API, формат автентифікації, словник областей доступу та схему підпису вебхуків, тож ШІ може створити робочу інтеграцію та запитати у вас потрібні деталі.
Документація
Картка Documentation містить посилання на повну документацію для розробників і OpenAPI spec, який описує кожен маршрут і схему. Connect MCP відкриває налаштування для підключення агентів ШІ безпосередньо до Exayard.
Журнали
Розділ Logs записує ваші найновіші запити до API як по REST API, так і по MCP. Кожен рядок показує метод, шлях, статус відповіді та затримку. Виберіть рядок, щоб побачити його повну деталізацію, зокрема ідентифікатор запиту та тіла запиту й відповіді. Використовуйте журнали, щоб підтвердити, що виклик спрацював, або щоб налагодити інтеграцію, яка не працює.
