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ı tarafından yetkilendirilmiş erişim için OAuth 2.1, imzalı webhook'lar ve kullanıma hazır bir TypeScript SDK.
Belgeleri inceleyinEksiksiz 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 (örn. kuruş/sent) 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 kapsam bazlı (sınırlı) erişim.
- Güvenli kullanıcı tarafından yetkilendirilmiş 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 kontrol panelinizden değiştirin
- Canlıya geçmeden önce sandbox verisiyle test edin
İmzalı Webhook'lar
Bir şey değiştiğinde 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ı
Başlarken
Dakikalar içinde SDK'mız veya REST API ile geliştirmeye başlayın. developers.yappointment.com adresinde tam belgeler ve etkileşimli örnekler bulabilirsiniz.
Belgeleri görüntüleyinimport { 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, tekrarlayan (kalıp) kod 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.
Farkı görmeye hazır mısınız?
14 gün. Tam erişim. Kredi kartı gerekmez. Kaybedecek hiçbir şeyiniz yok.
Avrupa genelinde işletme sahipleri, yönetim karmaşasını gerçekten işe yarayan tek bir platformla değiştirdiler. Bugün onlara katılın.
14 günlük ücretsiz deneme • Komisyonsuz — her zaman • İstediğiniz zaman iptal edin