Pereiti prie pagrindinio turinio
Kurkite ant yAppointment pagrindo 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.

Read the Docs

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 galinių taškų 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 neatskleidę kredencialų

Serverio ir viešieji API raktai

Išduokite serverio raktus (yapp_sk_*) galinėms 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 serverio-serverio 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 prieš smėlio dėžę prieš pradedant tiesiogiai

Pasirašyti Webhooks

Gaukite pranešimą iškart, kai kažkas pasikeičia. yAppointment pristato 9 įvykių tipus į jūsų HTTPS galinius 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

Getting Started

Start building with our SDK or REST API in minutes. Full documentation and interactive examples at developers.yappointment.com.

View Documentation
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žianti greitai ir maloniai integruoti yAppointment

TypeScript SDK

Venkite šabloninio kodo naudodami mūsų oficialų TypeScript SDK 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, ieškoti ir išbandyti kūrimo metu.

Tiesioginė ir bandomoji 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 daro rezervacijų kūrimą saugų kartoti, todėl tinklo sutrikimai niekada nevirs dvigubomis rezervacijomis.

Pasiruošę pamatyti, kas keičiasi?

14 dienų. Pilna prieiga. Be kreditinės kortelės. Ką jūs rizikuojate?

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

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