Appointer API · v1Beta

Створюйте інтеграції на основі Appointer.

REST API та підписані вебхуки для всього у вашому акаунті — записів, клієнтів, послуг, спеціалістів і локацій. Читайте, записуйте та реагуйте в реальному часі.

Ключі видаються в розділі Налаштування → Розробник · прив’язані до робочого простору · показуються один раз

API наразі в Beta. Ендпоінти стабільні й готові до використання — про будь-які несумісні зміни ми попередимо заздалегідь.

Вбудована ідемпотентність

Вебхуки в реальному часі

$ curl https://api.appointer.co/v1/appointments \
     -H "Authorization: Bearer ak_live_…"
     -H "Accept: application/json" ▋

Базова URL-адреса

api.appointer.co/v1

Один хост, усі ендпоінти

Транспорт

TLS 1.2+

HTTPS обов’язковий для кожного виклику

Версіонування

v1 · стабільна

Зміни, що порушують сумісність, виходять у новій версії

Обмеження частоти запитів

10,000 / hr

На робочий простір · 429 із Retry-After

Автентифікація

Bearer-ключі, прив’язані до одного робочого простору.

Автентифікуйте кожен запит секретним ключем API у заголовку Authorization. Згенеруйте його в розділі Налаштування → Розробник — він може читати та записувати дані лише в межах цього робочого простору.

Прив’язаний до робочого простору. Ключ ніколи не виходить за межі робочого простору, який його видав.

Показується один раз. Повний секрет з’являється лише один раз, під час створення. Зберігайте його на сервері.

Можна відкликати. Оновлюйте або відкликайте ключ миттєво — старі ключі одразу повертають 401.

заголовки запиту

# кожен запит містить bearer-токен, прив’язаний до робочого простору
Authorization: Bearer ak_live_AbCd3f9K2mQ7xR1pN8sV4tZ6wY0jL5hT

Ніколи не розміщуйте секретний ключ у клієнтському коді чи публічному репозиторії. Для контексту браузера використовуйте вбудовуваний віджет запису.

Що можна створити

Від одного календаря до цілої платформи.

API надає доступ до тих самих сутностей, з якими ви працюєте щодня, — записів, клієнтів, послуг, спеціалістів і локацій.

Власний віджет запису

Отримуйте актуальну доступність і створюйте записи безпосередньо з вашого вебсайту чи застосунку.

Синхронізація з CRM

Віддзеркалюйте клієнтів і всю історію їхніх записів у HubSpot, Salesforce чи вашій власній CRM.

Експорт у аналітику та BI

Передавайте записи, дохід і неявки у ваше сховище даних, Looker чи фінансову таблицю.

Власні сповіщення

Реагуйте на вебхуки, щоб надсилати власні SMS, повідомлення в Slack чи нагадування після візиту.

Запис через ШІ-асистента

Дозвольте асистенту переглядати вільні слоти та створювати записи від імені клієнта, а потім підтверджувати в чаті.

Робота з кількома локаціями

Керуйте робочими годинами спеціалістів і зводьте календарі кількох локацій в одну панель.

Вебхуки

У реальному часі та з підписом.

Зареєструйте ендпоінт, і Appointer надішле POST-запитом JSON-payload у момент спрацювання події. Кожна доставка підписується секретом окремого ендпоінта у заголовку X-Appointer-Signature — повторно обчисліть HMAC-SHA256 від необробленого тіла та порівняйте за сталий час, щоб переконатися, що вона надійшла від нас.

Подія

Коли спрацьовує

appointment.created

Запис створено через будь-який канал — сторінку, вбудований віджет або адмінпанель.

appointment.cancelled

Клієнт або спеціаліст скасовує запис.

appointment.rescheduled

Наявний запис переноситься на новий час або до іншого спеціаліста.

appointment.completed

Запис позначено як виконаний, клієнта обслуговано.

appointment.no_show

Клієнт не з’явився, і слот позначено відповідно.

Повний довідник

Кожен ендпоінт із документацією.

Переглядайте повний довідник OpenAPI — схеми запитів і відповідей, коди помилок, пагінацію та ідемпотентність, а також повний каталог подій вебхуків.