Geliştirici Merkezi ve Genel API
Geliştiricilerin yAppointment'ı kendi ürünlerine entegre etmesi için ihtiyaç duydukları her şey — genel bir REST API, kullanıcı yetkili erişim için OAuth 2.1, imzalı webhook'lar ve kullanıma hazır bir TypeScript SDK.
Read the DocsEksiksiz Bir Geliştirici Platformu
yAppointment'ı uygulamalarınız, iş akışlarınız ve entegrasyonlarınızla bağlamak için üretime hazır yapı taşları
Genel REST API
/api/v1 üzerinde şirket, rezervasyon ve müşteri verilerinizi okuyup yazmak için temiz ve tutarlı bir REST API — idempotency key'leri sayesinde yeniden denemeler hiçbir zaman çift rezervasyona yol açmaz.
- Şirket, rezervasyon ve müşteri verilerini okuyun ve yazın
- İdempotency key'leri ile güvenli rezervasyon oluşturma
- Webhook uç noktalarınızı programatik olarak yönetin
- Hassas hesaplamalar için küçük birimlerde (kuruş) döndürülen fiyatlar
- Tutarlı ve iyi yapılandırılmış JSON yanıtları
OAuth 2.1 + PKCE
Kullanıcılarınızın yAppointment hesabını uygulamanıza Authorization Code akışı ve PKCE ile güvenli biçimde bağlamasına izin verin — şifre paylaşımı yok, yalnızca kapsamlı erişim.
- Güvenli kullanıcı yetkili erişim için PKCE ile Authorization Code akışı
- Ayrıntılı kapsamlar: read/write:bookings ve read/write:customers
- read:profile ve read:analytics ile profil ve analitik erişimi
- webhooks:manage kapsamı üzerinden webhook yönetimi
- Kullanıcılar kimlik bilgilerini paylaşmadan erişim izni verir
Sunucu ve Genel API Anahtarları
Backend entegrasyonları için sunucu anahtarları (yapp_sk_*) ve istemci taraflı kullanım için genel anahtarlar (yapp_pk_*) oluşturun; tamamen ayrı canlı ve test ortamlarıyla.
- Güvenilir sunucudan sunucuya çağrılar için sunucu anahtarları (yapp_sk_*)
- Güvenli istemci taraflı kullanım için genel anahtarlar (yapp_pk_*)
- Güvenle geliştirmek için ayrı canlı ve test ortamları
- Anahtarları istediğiniz zaman panonuzdan değiştirin
- Canlıya geçmeden önce sandbox verisiyle test edin
İmzalı Webhook'lar
Bir şey değiştiği anda anında bildirim alın. yAppointment, otomatik yeniden denemeler ve tam teslimat takibi ile HTTPS uç noktalarınıza 9 olay türü gönderir.
- Rezervasyonları, müşterileri, hizmetleri ve çalışanları kapsayan 9 olay türü
- booking.created, booking.updated ve booking.cancelled olayları
- whsec_ imzalama gizli anahtarıyla yalnızca HTTPS uç noktaları
- yapp-signature başlığında HMAC-SHA256 imzaları
- Teslimat takibi ile otomatik yeniden denemeler ve panodan test teslimatları
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);Harika Bir Geliştirici Deneyimi İçin Tasarlandı
yAppointment entegrasyonunu hızlı ve keyifli kılan araçlar ve dokümantasyon
TypeScript SDK
Gereksiz tekrar kodu yazmaktan kurtulun: npm'deki resmi TypeScript SDK'mız — @lohisoftsro/yappointment-sdk — OpenAPI spesifikasyonumuzdan doğrudan üretilmiş, ESM ve CJS desteğiyle birlikte.
Etkileşimli Geliştirici Belgeleri
developers.yappointment.com adresinde her uç noktayı etkileşimli Scalar API referansıyla keşfedin — geliştirirken okuyun, arayın ve deneyin.
Canlı ve Test Modları
Ayrı canlı ve test API anahtarları, güvenle geliştirmenizi ve deneme yapmanızı sağlar; hazır olduğunuzda gerçek verilere dokunmadan üretime geçin.
Güvenli Yeniden Denemeler
İdempotency key'leri rezervasyon oluşturmayı yeniden denemekte güvenli kılar; böylece ağ sorunları hiçbir zaman çift randevuya dönüşmez.
Nelerin değişeceğini görmek ister misiniz?
14 gün. Tam erişim. Kredi kartı gerekmez. Ne kaybedebilirsiniz ki?
Avrupa genelinde işletme sahipleri, yönetim karmaşasını tek bir işe yarayan platformla değiştirdi. Bugün onlara katılın.
14 günlük ücretsiz deneme • Komisyonsuz — her zaman • İstediğiniz zaman iptal edin