Центр для розробників та публічний API
Все необхідне розробникам для інтеграції yAppointment у власні продукти — публічний REST API, OAuth 2.1 для делегованого доступу, підписані вебхуки та готовий до використання TypeScript SDK.
Read the DocsПовноцінна платформа для розробників
Готові до продакшену блоки для підключення yAppointment до ваших застосунків, робочих процесів та інтеграцій
Публічний REST API
Чистий, передбачуваний REST API за адресою /api/v1 для читання та запису даних вашої компанії, бронювань та клієнтів — з ключами ідемпотентності, щоб повторні запити ніколи не дублювали бронювання.
- Читання та запис даних компанії, бронювань та клієнтів
- Ідемпотентне створення бронювань за допомогою ключів ідемпотентності
- Програмне управління вашими вебхук-ендпоінтами
- Ціни повертаються в мінімальних одиницях (центи) для точних розрахунків
- Послідовні, добре структуровані JSON-відповіді
OAuth 2.1 + PKCE
Дозвольте користувачам безпечно підключати їхній акаунт yAppointment до вашого застосунку за допомогою потоку Authorization-Code та PKCE — без обміну паролями, лише з обмеженим доступом.
- Потік Authorization-Code з PKCE для безпечного делегованого доступу
- Гранульовані скопи: read/write:bookings та read/write:customers
- Доступ до профілю та аналітики через read:profile та read:analytics
- Управління вебхуками через скоп webhooks:manage
- Користувачі надають доступ без передачі облікових даних
Серверні та публічні ключі API
Видавайте серверні ключі (yapp_sk_*) для бекенд-інтеграцій та публічні ключі (yapp_pk_*) для клієнтської сторони, з повністю окремими бойовим та тестовим середовищами.
- Серверні ключі (yapp_sk_*) для довірених серверних викликів
- Публічні ключі (yapp_pk_*) для безпечного використання на клієнтській стороні
- Окремі бойове та тестове середовища для впевненої розробки
- Ротація ключів у будь-який час із вашого дашборду
- Тестування на пісочничних даних перед запуском у продакшен
Підписані вебхуки
Отримуйте сповіщення щойно щось змінюється. yAppointment доставляє 9 типів подій на ваші HTTPS-ендпоінти з автоматичними повторними спробами та повним відстеженням доставки.
- 9 типів подій, що охоплюють бронювання, клієнтів, послуги та співробітників
- Події booking.created, booking.updated та booking.cancelled
- Лише HTTPS-ендпоінти з секретом підпису whsec_
- HMAC-SHA256 підписи в заголовку yapp-signature
- Автоматичні повторні спроби з відстеженням доставки та тестовими доставками з дашборду
Getting Started
Start building with our SDK or REST API in minutes. Full documentation and interactive examples at developers.yappointment.com.
View Documentationimport { YAppointmentClient } from
'@lohisoftsro/yappointment-sdk';
const client = new YAppointmentClient({
apiKey: process.env.API_KEY,
baseUrl: 'https://api.yappointment.com'
});
// Create a booking
const booking = await client.bookings.create({
serviceId: 'srv_123',
customerId: 'cst_456',
startTime: '2025-07-01T10:00:00Z',
idempotencyKey: 'req_xyz789'
});
console.log('Booked:', booking.id);Створено для відмінного досвіду розробника
Інструменти та документація, що роблять інтеграцію yAppointment швидкою та приємною
TypeScript SDK
Пропустіть шаблонний код завдяки нашому офіційному TypeScript SDK на npm — @lohisoftsro/yappointment-sdk — згенерованому прямо з нашої специфікації OpenAPI, з підтримкою ESM та CJS.
Інтерактивна документація для розробників
Досліджуйте кожен ендпоінт на developers.yappointment.com за допомогою інтерактивного довідника API Scalar, який можна читати, шукати та випробовувати під час розробки.
Бойовий та тестовий режими
Окремі бойові та тестові ключі API дозволяють безпечно розробляти та експериментувати, а потім перемикатися на продакшен, коли ви готові, — без торкання реальних даних.
Безпечні повторні запити
Ключі ідемпотентності роблять створення бронювань безпечним для повтору, тому мережеві збої ніколи не перетворюються на дублюючі записи.
Готові побачити, що зміниться?
14 днів. Повний доступ. Без кредитної картки. Що ви маєте втратити?
Власники бізнесу по всій Європі замінили адміністративний хаос однією платформою, яка просто працює. Приєднуйтесь до них сьогодні.
14-денний безкоштовний пробний період • Без комісії — завжди • Скасувати будь-коли