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än valtuuttamaan pääsyyn, allekirjoitetut webhookit ja valmis TypeScript SDK.
Lue dokumentaatioTä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än valtuuttamaan 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ä palvelinavaimia (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äätepisteillesi 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ä
Aloittaminen
Aloita rakentaminen SDK:llamme tai REST API:llamme minuuteissa. Täydellinen dokumentaatio ja interaktiiviset esimerkit osoitteessa developers.yappointment.com.
Näytä dokumentaatioimport { 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 boilerplate-koodi virallisella TypeScript SDK:llämme npm:ssä (@lohisoftsro/yappointment-sdk), joka on generoitu suoraan OpenAPI-spesifikaatiostamme ja tukee sekä ESM- että CJS-muotoja.
Interaktiivinen kehittäjädokumentaatio
Tutustu kaikkiin päätepisteisiin 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
Idempotenssiavainten ansiosta varauksen luominen on turvallista yrittää uudelleen, joten verkko-ongelmat eivät koskaan muutu kaksoisvarauksiksi.
Valmiina näkemään eron?
14 päivää. Täysi käyttöoikeus. Ei luottokorttia. Ei mitään menetettävää.
Yrittäjät ympäri Eurooppaa ovat korvanneet hallinnollisen kaaoksen yhdellä alustalla, joka toimii. Liity heihin tänään.
14 päivän ilmainen kokeilu • Provisiovapaa — aina • Peruutus milloin tahansa