Разработчически хъб и публичен API
Всичко, от което разработчиците се нуждаят, за да интегрират yAppointment в собствените си продукти — публичен REST API, OAuth 2.1 за делегиран потребителски достъп, подписани уебхуци и готов за употреба TypeScript SDK.
Прочетете документациятаПълноценна разработчическа платформа
Готови за производство градивни блокове за свързване на 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
- Автоматични повторни опити с проследяване на доставките и тестови доставки от таблото
Първи стъпки
Започнете разработка с нашия SDK или REST API за броени минути. Пълна документация и интерактивни примери на developers.yappointment.com.
Преглед на документациятаimport { 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 дни безплатен пробен период • Без комисионна — винаги • Анулиране по всяко време