Preskočiť na hlavný obsah
Stavajte na yAppointment pomocou REST API, OAuth, webhookov a TypeScript SDK

Centrum pre vývojárov a verejné API

Všetko, čo vývojári potrebujú na integráciu yAppointment do vlastných produktov — verejné REST API, OAuth 2.1 pre prístup delegovaný používateľom, podpísané webhooky a TypeScript SDK pripravený na použitie.

Read the Docs

Kompletná vývojárska platforma

Produkčne pripravené stavebné bloky na prepojenie yAppointment s vašimi aplikáciami, pracovnými postupmi a integráciami

Verejné REST API

Čisté, predvídateľné REST API na /api/v1 na čítanie a zápis údajov o vašej firme, rezerváciách a zákazníkoch — s kľúčmi idempotentnosti, aby opakované pokusy nikdy nevytvárali duplicitné rezervácie.

  • Čítanie a zápis údajov o firme, rezerváciách a zákazníkoch
  • Idempotentné vytváranie rezervácií pomocou kľúčov idempotentnosti
  • Programatická správa koncových bodov webhookov
  • Ceny vrátené v menších jednotkách (centy) pre presné výpočty
  • Konzistentné, dobre štruktúrované JSON odpovede

OAuth 2.1 + PKCE

Umožnite svojim používateľom bezpečne prepojiť ich konto yAppointment s vašou aplikáciou pomocou toku Authorization Code a PKCE — bez zdieľania hesiel, iba s obmedzeným prístupom.

  • Tok Authorization Code s PKCE pre bezpečný prístup delegovaný používateľom
  • Granulárne rozsahy: read/write:bookings a read/write:customers
  • Prístup k profilom a analytike cez read:profile a read:analytics
  • Správa webhookov prostredníctvom rozsahu webhooks:manage
  • Používatelia udeľujú prístup bez zdieľania prihlasovacích údajov

Serverové a verejné API kľúče

Vydávajte serverové kľúče (yapp_sk_*) pre backendové integrácie a verejné kľúče (yapp_pk_*) pre použitie na strane klienta, s úplne oddelenými živými a testovacími prostrediami.

  • Serverové kľúče (yapp_sk_*) pre dôveryhodné volania server-server
  • Verejné kľúče (yapp_pk_*) pre bezpečné použitie na strane klienta
  • Oddelené živé a testovacie prostredia pre vývoj s istotou
  • Kedykoľvek rotujte kľúče z vášho dashboardu
  • Testujte na sandbox dátach pred spustením do produkcie

Podpísané webhooky

Dostávajte upozornenia okamžite, keď sa niečo zmení. yAppointment doručuje 9 typov udalostí na vaše HTTPS koncové body s automatickým opakovaním a úplným sledovaním doručenia.

  • 9 typov udalostí pokrývajúcich rezervácie, zákazníkov, služby a zamestnancov
  • Udalosti booking.created, booking.updated a booking.cancelled
  • Iba HTTPS koncové body s podpisovým tajomstvom whsec_
  • HMAC-SHA256 podpisy v hlavičke yapp-signature
  • Automatické opakovanie so sledovaním doručenia, plus testovacie doručenia z dashboardu

Getting Started

Start building with our SDK or REST API in minutes. Full documentation and interactive examples at developers.yappointment.com.

View Documentation
api-example.ts
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);

Navrhnuté pre skvelý vývojársky zážitok

Nástroje a dokumentácia, vďaka ktorým je integrácia yAppointment rýchla a príjemná

TypeScript SDK

Preskočte štandardný kód s našim oficiálnym TypeScript SDK na npm — @lohisoftsro/yappointment-sdk — generovaným priamo z nášho OpenAPI spec, s podporou ESM a CJS.

Interaktívna vývojárska dokumentácia

Preskúmajte každý koncový bod na developers.yappointment.com s interaktívnou Scalar API referenciou, ktorú môžete čítať, prehľadávať a vyskúšať počas vývoja.

Živý a testovací režim

Oddelené živé a testovacie API kľúče umožňujú bezpečne vyvíjať a experimentovať, potom prejsť do produkcie, keď ste pripravení — bez zásahu do skutočných dát.

Bezpečné opakovanie

Kľúče idempotentnosti robia vytváranie rezervácií bezpečným na opakované pokusy, takže sieťové výpadky nikdy nevytvoria duplicitné stretnutia.

Pripravení vidieť, čo sa zmení?

14 dní. Plný prístup. Bez karty. Čo máte čo stratiť?

Majitelia firiem po celej Európe nahradili administratívny chaos jednou platformou, ktorá jednoducho funguje. Pripojte sa k nim ešte dnes.

14-dňová bezplatná skúšobná verzia • Bez provízií — vždy • Zrušenie kedykoľvek