Kehittäjäkeskus ja julkinen API
Kaikki mitä kehittäjät tarvitsevat yAppointmentin integroimiseen omiin tuotteisiinsa — julkinen REST API, OAuth 2.1 käyttäjävaltuutettuun pääsyyn, allekirjoitetut webhookit ja valmis TypeScript SDK.
Read the DocsTäydellinen kehittäjäalusta
Tuotantovalmiit rakennuspalikat yAppointmentin yhdistämiseksi sovelluksiisi, työnkulkuihisi ja integraatioihisi
Julkinen REST API
Selkeä ja ennustettava REST API osoitteessa /api/v1 yrityksesi, varausten ja asiakastietojen lukemiseen ja kirjoittamiseen — idempotenssiavainten ansiosta uudelleenyritykset eivät koskaan johda kaksoisvarauksiin.
- Yritys-, varaus- ja asiakastietojen luku ja kirjoitus
- Idempotentti varauksen luominen idempotenssiavainten avulla
- Webhook-päätepisteiden hallinta ohjelmallisesti
- Hinnat palautetaan pienimmissä yksiköissä (senteissä) tarkkoja laskelmia varten
- Johdonmukaiset, hyvin jäsennellyt JSON-vastaukset
OAuth 2.1 + PKCE
Anna käyttäjiesi yhdistää yAppointment-tilinsä sovellukseesi turvallisesti Authorization-Code-vuon ja PKCE:n avulla — ei salasanojen jakamista, vain rajattu pääsy.
- Authorization-Code-vuo PKCE:llä turvalliseen käyttäjävaltuutettuun pääsyyn
- Tarkat käyttöoikeusalueet: read/write:bookings ja read/write:customers
- Profiilin ja analytiikan käyttö read:profile- ja read:analytics-alueilla
- Webhook-hallinta webhooks:manage-alueen kautta
- Käyttäjät myöntävät pääsyn jakamatta koskaan tunnistetietoja
Palvelin- ja julkiset API-avaimet
Myönnä palvelinavaineita (yapp_sk_*) backend-integraatioihin ja julkisia avaimia (yapp_pk_*) asiakaspuolen käyttöön, täysin erillisillä live- ja testiympäristöillä.
- Palvelinavaimet (yapp_sk_*) luotettuihin palvelin-palvelin-kutsuihin
- Julkiset avaimet (yapp_pk_*) turvalliseen asiakaspuolen käyttöön
- Erilliset live- ja testiympäristöt kehittämiseen luottavaisesti
- Avainten vaihto milloin tahansa koontinäytöltäsi
- Testaa hiekkalaatikkoaineistolla ennen tuotantoon siirtymistä
Allekirjoitetut webhookit
Saa ilmoitus heti kun jokin muuttuu. yAppointment toimittaa 9 tapahtumatyyppiä HTTPS-päätepisteilläsi automaattisilla uudelleenyrityksillä ja täydellisellä toimituksen seurannalla.
- 9 tapahtumatyyppiä varausten, asiakkaiden, palveluiden ja työntekijöiden kattamiseksi
- booking.created-, booking.updated- ja booking.cancelled-tapahtumat
- Vain HTTPS-päätepisteet whsec_-allekirjoitussalaisuudella
- HMAC-SHA256-allekirjoitukset yapp-signature-otsikossa
- Automaattiset uudelleenyritykset toimituksen seurannalla sekä testilähetykset koontinäytöltä
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);Rakennettu erinomaiselle kehittäjäkokemukselle
Työkalut ja dokumentaatio, jotka tekevät yAppointmentin integroinnista nopeaa ja miellyttävää
TypeScript SDK
Ohita kattilakoodi virallisella TypeScript SDK:llämme npm:ssä — @lohisoftsro/yappointment-sdk — generoitu suoraan OpenAPI-spesifikaatiostamme, ESM- ja CJS-tuella.
Interaktiivinen kehittäjädokumentaatio
Tutustu kaikkiin päätepistiin osoitteessa developers.yappointment.com interaktiivisen Scalar API -viitteen avulla, jota voit lukea, etsiä ja kokeilla rakentaessasi.
Live- ja testitilat
Erilliset live- ja testi-API-avaimet antavat sinun rakentaa ja kokeilla turvallisesti, sitten vaihtaa tuotantoon kun olet valmis — koskematta todelliseen dataan.
Turvalliset uudelleenyritykset
Idempotenssiavaimet tekevät varauksen luomisesta turvallista yrittää uudelleen, joten verkko-ongelmat eivät koskaan muutu kaksoisajanvarauksiksi.
Valmiina näkemään mikä muuttuu?
14 päivää. Täysi käyttöoikeus. Ilman luottokorttia. Mitä sinulla on hävittävänä?
Yrittäjät ympäri Euroopan ovat korvanneet hallinnollisen kaaoksen yhdellä alustalla, joka toimii. Liity heihin tänään.
14 päivän ilmainen kokeilu • Provisiovapaa — aina • Peruutus milloin tahansa