Разработчически хъб и публичен API
Всичко, което разработчиците се нуждаят, за да интегрират yAppointment в собствените си продукти — публичен REST API, OAuth 2.1 за делегиран потребителски достъп, подписани уебхуци и готов за употреба TypeScript SDK.
Read the DocsПълноценна разработчическа платформа
Готови за производство градивни блокове за свързване на yAppointment с вашите приложения, работни процеси и интеграции
Публичен REST API
Чист и предвидим REST API на /api/v1 за четене и запис на данни за вашата фирма, резервации и клиенти — с idempotency ключове, така че повторните опити никога не водят до двойни резервации.
- Четене и запис на данни за фирма, резервации и клиенти
- Идемпотентно създаване на резервации с idempotency ключове
- Програмно управление на вашите уебхук крайни точки
- Цените се връщат в минимални единици (стотинки) за прецизни изчисления
- Последователни, добре структурирани 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 с интерактивна Scalar API справка, която можете да четете, търсите и изпробвате докато разработвате.
Режими за живо и тестово
Разделените ключове за живо и тестово API ви позволяват да изграждате и експериментирате безопасно, след което да преминете към производство когато сте готови — без да засягате реални данни.
Безопасни повторни опити
Idempotency ключовете правят създаването на резервации безопасно за повторен опит, така че мрежовите проблеми никога не водят до дублирани часове.
Готови ли сте да видите какво се променя?
14 дни. Пълен достъп. Без кредитна карта. Какво имате за губене?
Собственици на бизнес в цяла Европа замениха административния хаос с една платформа, която просто работи. Присъединете се към тях днес.
14 дни безплатен пробен период • Без комисиона — винаги • Анулиране по всяко време