Fejlesztői hub és nyilvános API
Minden, amire a fejlesztőknek szükségük van a yAppointment integrálásához saját termékükbe — nyilvános REST API, OAuth 2.1 felhasználó-delegált hozzáféréshez, aláírt webhookok és egy kész TypeScript SDK.
Read the DocsEgy teljes fejlesztői platform
Gyártásra kész építőelemek a yAppointment alkalmazásokhoz, munkafolyamatokhoz és integrációkhoz való csatlakoztatásához
Nyilvános REST API
Letisztult, kiszámítható REST API a /api/v1 útvonalon a vállalati, foglalási és ügyféladatok olvasásához és írásához — idempotencia-kulcsokkal, hogy az újrapróbálkozások soha ne eredményezzenek dupla foglalást.
- Vállalati, foglalási és ügyféladatok olvasása és írása
- Idempotens foglaláslétrehozás idempotencia-kulcsokkal
- Webhook-végpontok programozott kezelése
- Az árak kis egységekben (fillérek) érkeznek a pontos számításokhoz
- Következetes, jól strukturált JSON-válaszok
OAuth 2.1 + PKCE
Engedd, hogy felhasználóid biztonságosan összekapcsolják yAppointment-fiókjukat az alkalmazásoddal az engedélyezési kód folyamatán és PKCE-n keresztül — jelszómegosztás nélkül, kizárólag hatókörrel korlátozott hozzáféréssel.
- Engedélyezési kód folyamat PKCE-vel a biztonságos felhasználó-delegált hozzáférésért
- Részletes hatókörök: read/write:bookings és read/write:customers
- Profil- és analitikai hozzáférés a read:profile és read:analytics hatókörökkel
- Webhook-kezelés a webhooks:manage hatókörrel
- A felhasználók hitelesítő adatok megosztása nélkül adnak hozzáférést
Szerver- és nyilvános API-kulcsok
Szerver-kulcsokat (yapp_sk_*) adhatsz ki backend integrációkhoz és nyilvános kulcsokat (yapp_pk_*) kliens oldali használathoz, teljesen elkülönített éles és teszt környezetekkel.
- Szerverkulcsok (yapp_sk_*) megbízható szerver–szerver hívásokhoz
- Nyilvános kulcsok (yapp_pk_*) biztonságos kliens oldali használathoz
- Elkülönített éles és teszt környezetek a magabiztos fejlesztéshez
- Kulcsok rotálása bármikor az irányítópultról
- Tesztelés sandbox-adatokon az éles bevezetés előtt
Aláírt webhookok
Értesülj azonnal, amint valami megváltozik. A yAppointment 9 eseménytípust küld a HTTPS-végpontjaidra automatikus újrapróbálkozással és teljes kézbesítéskövetéssel.
- 9 eseménytípus foglalásokhoz, ügyfelekhez, szolgáltatásokhoz és alkalmazottakhoz
- booking.created, booking.updated és booking.cancelled események
- Kizárólag HTTPS-végpontok whsec_ aláíró titokkal
- HMAC-SHA256 aláírások a yapp-signature fejlécben
- Automatikus újrapróbálkozás kézbesítéskövetéssel és tesztkézbesítések az irányítópultról
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);Kiváló fejlesztői élményre tervezve
Az eszközök és dokumentáció, amelyek gyorssá és kellemessé teszik a yAppointment integrálását
TypeScript SDK
Hagyd ki a sablonkódot a hivatalos TypeScript SDK-val npm-en — @lohisoftsro/yappointment-sdk — közvetlenül az OpenAPI specifikációból generálva, ESM és CJS támogatással.
Interaktív fejlesztői dokumentáció
Fedezd fel az összes végpontot a developers.yappointment.com oldalon, egy interaktív Scalar API-referenciával, amelyet olvashatsz, kereshetsz és kipróbálhatsz fejlesztés közben.
Éles és teszt módok
Az elkülönített éles és teszt API-kulcsok lehetővé teszik, hogy biztonságosan fejlessz és kísérletezz, majd váltasz az éles üzemre, ha készen vagy — valódi adatok érintése nélkül.
Biztonságos újrapróbálkozások
Az idempotencia-kulcsok biztonságossá teszik a foglaláslétrehozás újrapróbálkozását, hogy a hálózati zavarok soha ne eredményezzenek dupla találkozót.
Kezdd el a változást még ma.
14 nap. Teljes hozzáférés. Nem kell bankkártya. Mit veszíthetsz?
Vállalkozók Európa-szerte az admin-káoszt egy platformra cserélték, ami egyszerűen működik. Csatlakozz hozzájuk te is.
14 napos ingyenes próba • Jutalékmentes — mindig • Bármikor lemondható