Preskoči na glavni sadržaj
Proširite yAppointment REST API-jem, OAuthom, webhookovima i TypeScript SDK-om

Developer Hub i javni API

Sve što programeri trebaju za integraciju yAppointmenta u vlastite proizvode — javni REST API, OAuth 2.1 za pristup koji delegira korisnik, potpisani webhookovi i gotov TypeScript SDK.

Pročitajte dokumentaciju

Kompletna razvojna platforma

Gotovi gradivni blokovi za spajanje yAppointmenta s vašim aplikacijama, radnim tokovima i integracijama

Javni REST API

Čist i predvidljiv REST API na /api/v1 za čitanje i pisanje podataka o tvrtki, rezervacijama i klijentima — s ključevima idempotencije kako ponovljeni zahtjevi nikada ne bi uzrokovali dvostruku rezervaciju.

  • Čitanje i pisanje podataka o tvrtki, rezervacijama i klijentima
  • Idempotentno kreiranje rezervacija uz ključeve idempotencije
  • Programatsko upravljanje webhook-endpointima
  • Cijene vraćene u manjim jedinicama (centi) za precizne izračune
  • Dosljedni, dobro strukturirani JSON odgovori

OAuth 2.1 + PKCE

Omogućite korisnicima da sigurno povežu svoj yAppointment račun s vašom aplikacijom uz tok Authorization-Code i PKCE — bez dijeljenja lozinki, samo pristup ograničen na unaprijed definirane opsege.

  • Tok Authorization-Code uz PKCE za siguran korisnički delegirani pristup
  • Granularni opsezi: read/write:bookings i read/write:customers
  • Pristup profilu i analitici putem read:profile i read:analytics
  • Upravljanje webhookovima putem opsega webhooks:manage
  • Korisnici dodjeljuju pristup bez ikakve razmjene vjerodajnica

Poslužiteljski i javni API ključevi

Izdajte poslužiteljske ključeve (yapp_sk_*) za backend integracije i javne ključeve (yapp_pk_*) za upotrebu na strani klijenta, uz potpuno odvojene produkcijske i testne okoline.

  • Poslužiteljski ključevi (yapp_sk_*) za pouzdane pozive između poslužitelja
  • Javni ključevi (yapp_pk_*) za sigurnu upotrebu na strani klijenta
  • Odvojene produkcijske i testne okoline za siguran razvoj
  • Rotirajte ključeve u bilo kojem trenutku putem nadzorne ploče
  • Testirajte na sandbox podacima prije prelaska u produkciju

Potpisani webhookovi

Budite obaviješteni čim se nešto promijeni. yAppointment dostavlja 9 vrsta događaja na vaše HTTPS-endpointe s automatskim ponovnim pokušajima i potpunim praćenjem dostave.

  • 9 vrsta događaja koji pokrivaju rezervacije, klijente, usluge i zaposlenike
  • Događaji booking.created, booking.updated i booking.cancelled
  • HTTPS-endpointi s tajnim ključevima za potpisivanje (prefiks whsec_)
  • HMAC-SHA256 potpisi u zaglavlju yapp-signature
  • Automatski ponovni pokušaji s praćenjem dostave, te testne isporuke putem nadzorne ploče

Početak rada

Počnite graditi s našim SDK-om ili REST API-jem za nekoliko minuta. Potpuna dokumentacija i interaktivni primjeri na developers.yappointment.com.

Pogledajte dokumentaciju
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);

Izgrađeno za odlično iskustvo programera

Alati i dokumentacija koji čine integraciju yAppointmenta brzom i ugodnom

TypeScript SDK

Preskočite boilerplate uz naš službeni TypeScript SDK na npm-u — @lohisoftsro/yappointment-sdk — generiran izravno iz naše OpenAPI specifikacije, s podrškom za ESM i CJS.

Interaktivna razvojna dokumentacija

Istražite svaki endpoint na developers.yappointment.com uz interaktivnu Scalar API referencu koju možete čitati, pretraživati i isprobavati dok gradite.

Produkcijski i testni način rada

Odvojeni produkcijski i testni API ključevi omogućuju siguran razvoj i eksperimentiranje, a kad budete spremni, jednostavno prijeđite na produkciju — bez diranja stvarnih podataka.

Sigurni ponovni pokušaji

Ključevi idempotencije čine kreiranje rezervacija sigurnim za ponavljanje, pa mrežni problemi nikada ne rezultiraju duplim terminima.

Spremni ste vidjeti razliku?

14 dana. Puni pristup. Bez kartice. Nemate što izgubiti.

Vlasnici tvrtki diljem Europe zamijenili su administrativni kaos jednom platformom koja jednostavno funkcionira. Pridružite im se danas.

14-dnevno besplatno probno razdoblje • Bez provizije — uvijek • Otkažite kad god želite