Centrum deweloperskie i publiczne API
Wszystko, czego deweloperzy potrzebują, by zintegrować yAppointment z własnymi produktami — publiczne REST API, OAuth 2.1 dla dostępu delegowanego przez użytkownika, podpisane webhooki i gotowy do użycia TypeScript SDK.
Read the DocsKompletna platforma deweloperska
Gotowe do produkcji elementy, które łączą yAppointment z Twoimi aplikacjami, przepływami pracy i integracjami
Publiczne REST API
Przejrzyste, przewidywalne REST API pod adresem /api/v1 do odczytu i zapisu danych Twojej firmy, rezerwacji i klientów — z kluczami idempotentności, dzięki którym ponowne próby nigdy nie tworzą duplikatów.
- Odczyt i zapis danych firmy, rezerwacji i klientów
- Idempotentne tworzenie rezerwacji za pomocą kluczy idempotentności
- Programowe zarządzanie endpointami webhooków
- Ceny zwracane w najmniejszych jednostkach (grosze) dla precyzyjnych obliczeń
- Spójne, dobrze ustrukturyzowane odpowiedzi JSON
OAuth 2.1 + PKCE
Pozwól swoim użytkownikom bezpiecznie połączyć konto yAppointment z Twoją aplikacją za pomocą przepływu Authorization-Code i PKCE — bez udostępniania haseł, wyłącznie z dostępem zakresowym.
- Przepływ Authorization-Code z PKCE dla bezpiecznego dostępu delegowanego przez użytkownika
- Szczegółowe zakresy: read/write:bookings oraz read/write:customers
- Dostęp do profilu i analityki przez read:profile i read:analytics
- Zarządzanie webhookami poprzez zakres webhooks:manage
- Użytkownicy przyznają dostęp bez ujawniania danych logowania
Klucze API serwerowe i publiczne
Wystawiaj klucze serwerowe (yapp_sk_*) do integracji backendowych i klucze publiczne (yapp_pk_*) do użytku po stronie klienta, z całkowicie oddzielnymi środowiskami produkcyjnymi i testowymi.
- Klucze serwerowe (yapp_sk_*) do zaufanych wywołań serwer-serwer
- Klucze publiczne (yapp_pk_*) do bezpiecznego użytku po stronie klienta
- Oddzielne środowiska produkcyjne i testowe, by rozwijać się pewnie
- Rotacja kluczy w dowolnym momencie z poziomu panelu
- Testowanie na danych piaskownicy przed wdrożeniem
Podpisane webhooki
Otrzymuj powiadomienia w momencie zmiany. yAppointment dostarcza 9 typów zdarzeń do Twoich endpointów HTTPS z automatycznymi ponownymi próbami i pełnym śledzeniem doręczeń.
- 9 typów zdarzeń obejmujących rezerwacje, klientów, usługi i pracowników
- Zdarzenia booking.created, booking.updated i booking.cancelled
- Endpointy wyłącznie HTTPS z tajemnicą podpisującą whsec_
- Podpisy HMAC-SHA256 w nagłówku yapp-signature
- Automatyczne ponowne próby ze śledzeniem doręczeń oraz testowe doręczenia z panelu
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);Stworzone dla doskonałego doświadczenia deweloperskiego
Narzędzia i dokumentacja, które sprawiają, że integracja yAppointment jest szybka i przyjemna
TypeScript SDK
Pomiń boilerplate dzięki naszemu oficjalnemu TypeScript SDK na npm — @lohisoftsro/yappointment-sdk — wygenerowanemu wprost ze specyfikacji OpenAPI, z obsługą ESM i CJS.
Interaktywna dokumentacja deweloperska
Eksploruj każdy endpoint na developers.yappointment.com z interaktywnym odniesieniem API Scalar, które możesz czytać, przeszukiwać i wypróbowywać podczas budowania.
Tryby produkcyjny i testowy
Oddzielne produkcyjne i testowe klucze API pozwalają bezpiecznie budować i eksperymentować, a gdy jesteś gotowy, przełączasz się na produkcję — bez dotykania prawdziwych danych.
Bezpieczne ponowne próby
Klucze idempotentności sprawiają, że tworzenie rezerwacji jest bezpieczne do ponowienia, więc problemy sieciowe nigdy nie zamieniają się w duplikaty wizyt.
Gotowy zobaczyć, co się zmieni?
14 dni. Pełny dostęp. Bez karty. Co tracisz?
Właściciele firm w całej Europie zastąpili chaos administracyjny jedną platformą, która po prostu działa. Dołącz do nich już dziś.
14-dniowy bezpłatny okres próbny • Bez prowizji — zawsze • Rezygnacja w dowolnym momencie