Hub pentru Dezvoltatori și API Public
Tot ce au nevoie dezvoltatorii pentru a integra yAppointment în propriile produse — un REST API public, OAuth 2.1 pentru acces delegat de utilizator, webhook-uri semnate și un TypeScript SDK gata de utilizat.
Citește documentațiaO platformă completă pentru dezvoltatori
Componente gata de producție pentru a conecta yAppointment cu aplicațiile, fluxurile și integrările tale
REST API Public
Un REST API curat și predictibil la /api/v1 pentru citirea și scrierea datelor despre companie, rezervări și clienți — cu chei de idempotență pentru ca reîncercările să nu creeze rezervări duble.
- Citește și scrie date despre companie, rezervări și clienți
- Creare idempotentă a rezervărilor cu chei de idempotență
- Gestionează endpoint-urile de webhook în mod programatic
- Prețuri returnate în unități minore (cenți) pentru calcule precise
- Răspunsuri JSON consistente și bine structurate
OAuth 2.1 + PKCE
Permite utilizatorilor să conecteze contul yAppointment la aplicația ta în siguranță, prin fluxul Authorization-Code și PKCE — fără partajarea parolelor, doar acces limitat la anumite scopuri (scopes).
- Flux Authorization-Code cu PKCE pentru acces sigur delegat de utilizator
- Scopuri granulare: read/write:bookings și read/write:customers
- Acces la profil și analize prin read:profile și read:analytics
- Gestionarea webhook-urilor prin scopul webhooks:manage
- Utilizatorii acordă acces fără a partaja niciodată credențialele
Chei API pentru server și client
Emite chei de server (yapp_sk_*) pentru integrările backend și chei publice (yapp_pk_*) pentru utilizarea pe partea de client, cu medii live și de test complet separate.
- Chei de server (yapp_sk_*) pentru apeluri de încredere server-to-server
- Chei publice (yapp_pk_*) pentru utilizare sigură pe partea de client
- Medii live și de test separate pentru dezvoltare cu încredere
- Rotește cheile oricând din panoul tău de control
- Testează pe date sandbox înainte de a trece la producție
Webhook-uri Semnate
Primești o notificare imediat ce apare o schimbare. yAppointment livrează 9 tipuri de evenimente la endpoint-urile tale HTTPS cu reîncercări automate și urmărire completă a livrărilor.
- 9 tipuri de evenimente acoperind rezervări, clienți, servicii și angajați
- Evenimente booking.created, booking.updated și booking.cancelled
- Endpoint-uri exclusiv HTTPS cu un secret de semnare whsec_
- Semnături HMAC-SHA256 în antetul yapp-signature
- Reîncercări automate cu urmărirea livrărilor și livrări de test din panou
Primii Pași
Începe să construiești cu SDK-ul nostru sau API-ul REST în câteva minute. Documentație completă și exemple interactive la developers.yappointment.com.
Vezi documentațiaimport { 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);Construit pentru o Experiență Excelentă a Dezvoltatorului
Instrumentele și documentația care fac integrarea yAppointment rapidă și plăcută
TypeScript SDK
Renunță la codul repetitiv cu SDK-ul nostru oficial TypeScript pe npm — @lohisoftsro/yappointment-sdk — generat direct din specificația noastră OpenAPI, cu suport ESM și CJS.
Documentație Interactivă pentru Dezvoltatori
Explorează fiecare endpoint la developers.yappointment.com cu o referință interactivă Scalar API pe care o poți citi, căuta și testa pe măsură ce construiești.
Moduri Live și de Test
Cheile API separate pentru live și test îți permit să construiești și să experimentezi în siguranță, apoi să treci la producție când ești gata — fără a atinge date reale.
Reîncercări Sigure
Cheile de idempotență fac crearea rezervărilor sigură pentru reîncercare, astfel că problemele de rețea nu se transformă niciodată în programări duplicate.
Gata să vezi diferența?
14 zile. Acces complet. Fără card de credit. Nimic de pierdut.
Proprietarii de afaceri din toată Europa au înlocuit haosul administrativ cu o platformă care pur și simplu funcționează. Alătură-te lor astăzi.
14 zile de probă gratuită • Fără comisioane — întotdeauna • Anulare oricând