Pereiti prie pagrindinio turinio
Kurkite yAppointment pagrindu naudodami REST API, OAuth, webhooks ir TypeScript SDK

Kūrėjų centras ir viešoji API

Viskas, ko kūrėjams reikia norint integruoti yAppointment į savo produktus — viešoji REST API, OAuth 2.1 vartotojų įgaliotai prieigai, pasirašyti webhooks ir paruoštas naudoti TypeScript SDK.

Skaityti dokumentaciją

Pilna kūrėjų platforma

Paruošti gamybai statybiniai blokai, leidžiantys sujungti yAppointment su jūsų programomis, darbo eigomis ir integracijomis

Viešoji REST API

Švari, nuspėjama REST API adresu /api/v1, skirta skaityti ir rašyti jūsų įmonės, rezervacijų ir klientų duomenis — su idempotentiškumo raktais, kad pakartotiniai bandymai niekada nesukurtų dvigubų rezervacijų.

  • Skaitykite ir rašykite įmonės, rezervacijų ir klientų duomenis
  • Idempotentiškas rezervacijų kūrimas su idempotentiškumo raktais
  • Tvarkykite savo webhook galinius taškus programiškai
  • Kainos grąžinamos smulkiaisiais vienetais (centais) tiksliam skaičiavimui
  • Nuoseklūs, gerai struktūrizuoti JSON atsakymai

OAuth 2.1 + PKCE

Leiskite savo vartotojams saugiai prijungti savo yAppointment paskyrą prie jūsų programos naudojant Autorizacijos kodo eigą ir PKCE — be slaptažodžių dalijimosi, tik ribota prieiga.

  • Autorizacijos kodo eiga su PKCE saugiai vartotojų įgaliotai prieigai
  • Detalizuotos apimtys: read/write:bookings ir read/write:customers
  • Profilio ir analizės prieiga per read:profile ir read:analytics
  • Webhooks valdymas per webhooks:manage apimtį
  • Vartotojai suteikia prieigą niekada neatskleisdami kredencialų

Serverio ir viešieji API raktai

Išduokite serverio raktus (yapp_sk_*) backend integracijoms ir viešuosius raktus (yapp_pk_*) kliento pusės naudojimui, su visiškai atskiromis tiesioginėmis ir bandomosiomis aplinkomis.

  • Serverio raktai (yapp_sk_*) patikimiems tarpserveriniams iškvietimams
  • Viešieji raktai (yapp_pk_*) saugiam kliento pusės naudojimui
  • Atskiros tiesioginės ir bandomosios aplinkos kūrimui su pasitikėjimu
  • Sukite raktus bet kada iš savo valdymo skydelio
  • Testuokite smėlio dėžėje prieš pereidami į tiesioginę aplinką

Pasirašyti Webhooks

Gaukite pranešimą iškart, kai kažkas pasikeičia. yAppointment pristato 9 įvykių tipus į jūsų HTTPS galutinius taškus su automatiniais pakartotiniais bandymais ir pilnu pristatymo sekimu.

  • 9 įvykių tipai apimantys rezervacijas, klientus, paslaugas ir darbuotojus
  • booking.created, booking.updated ir booking.cancelled įvykiai
  • Tik HTTPS galiniai taškai su whsec_ pasirašymo slaptu raktu
  • HMAC-SHA256 parašai yapp-signature antraštėje
  • Automatiniai pakartotiniai bandymai su pristatymo sekimu ir bandomaisiais pristatymais iš valdymo skydelio

Kaip pradėti

Pradėkite kurti su mūsų SDK arba REST API per kelias minutes. Pilna dokumentacija ir interaktyvūs pavyzdžiai adresu developers.yappointment.com.

Žiūrėti dokumentaciją
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);

Sukurta puikiai kūrėjų patirčiai

Įrankiai ir dokumentacija, leidžiantys greitai ir maloniai integruoti yAppointment

TypeScript SDK

Venkite šabloninio kodo naudodami mūsų oficialų TypeScript SDK, publikuotą npm — @lohisoftsro/yappointment-sdk — sugeneruotą tiesiai iš mūsų OpenAPI specifikacijos, su ESM ir CJS palaikymu.

Interaktyvi kūrėjų dokumentacija

Naršykite kiekvieną galinį tašką adresu developers.yappointment.com naudodami interaktyvią Scalar API nuorodą, kurią galite skaityti ir išbandyti bei kurioje galite ieškoti kūrimo metu.

Tiesioginiai ir bandomieji režimai

Atskiri tiesioginiai ir bandomieji API raktai leidžia kurti ir eksperimentuoti saugiai, tada pereiti į gamybą, kai esate pasiruošę — neliečiant realių duomenų.

Saugūs pakartotiniai bandymai

Idempotentiškumo raktai leidžia saugiai pakartoti rezervacijos kūrimą, todėl tinklo sutrikimai niekada nevirs dvigubomis rezervacijomis.

Pasiruošę pamatyti skirtumą?

14 dienų. Visapusiška prieiga. Be kreditinės kortelės. Nėra ko prarasti.

Verslo savininkai visoje Europoje pakeitė administracinį chaosą į vieną platformą, kuri tiesiog veikia. Prisijunkite šiandien.

14 dienų nemokamas bandomasis laikotarpis • Be komisinių – visada • Atšaukite bet kada