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.
Read the DocsO 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 cu domeniu limitat.
- Flux Authorization-Code cu PKCE pentru acces sigur delegat de utilizator
- Domenii granulare: read/write:bookings și read/write:customers
- Acces la profil și analize prin read:profile și read:analytics
- Gestionarea webhook-urilor prin domeniul 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
Fii notificat imediat ce se schimbă ceva. 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
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);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 ce se schimbă?
14 zile. Acces complet. Fără card de credit. Ce ai 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 probă gratuită • Fără comisioane — întotdeauna • Anulare oricând