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.
Dokumentáció elolvasásaEgy teljes fejlesztői platform
Éles környezetre kész építőelemek alkalmazások, munkafolyamatok és integrációk yAppointment-hez 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 a legkisebb pénznem-egységben (pl. cent) é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
Szerverkulcsokat (yapp_sk_*) adhatsz ki backend integrációkhoz és nyilvános kulcsokat (yapp_pk_*) kliensoldali 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 kliensoldali 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ókulccsal
- 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
Kezdő lépések
Kezdj el fejleszteni SDK-nkkal vagy REST API-nkkal percek alatt. Teljes dokumentáció és interaktív példák a developers.yappointment.com oldalon.
Dokumentáció megtekintéseimport { 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álts az éles üzemre, ha készen állsz — 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 foglalást.
Készen állsz, hogy lásd a különbséget?
14 nap. Teljes hozzáférés. Nem kell bankkártya. Nincs mit veszítened.
Vállalkozók Európa-szerte az adminisztrációs káoszt egyetlen, egyszerűen működő platformra cserélték le. Csatlakozz hozzájuk te is.
14 napos ingyenes próba • Jutalékmentes — mindig • Bármikor lemondható