مركز المطورين وAPI العامة
كل ما يحتاجه المطورون لدمج yAppointment في منتجاتهم — REST API عامة، وOAuth 2.1 للوصول المفوض من المستخدم، وwebhooks موقعة، وSDK جاهزة بلغة TypeScript.
اقرؤوا الوثائقمنصة مطورين متكاملة
لبنات جاهزة للإنتاج لربط yAppointment بتطبيقاتكم وسير عملكم وتكاملاتكم
REST API عامة
واجهة REST واضحة ومتوقعة على /api/v1 لقراءة بيانات شركتكم وحجوزاتكم وعملائكم وكتابتها — مع مفاتيح عدم التكرار (idempotency keys) حتى لا تؤدي إعادة المحاولة إلى حجز مزدوج أبدا.
- قراءة بيانات الشركة والحجوزات والعملاء وكتابتها
- إنشاء حجوزات دون تكرار بفضل مفاتيح idempotency
- إدارة نقاط استقبال webhooks برمجيا
- أسعار بالوحدات الصغرى (السنتات) لحسابات دقيقة
- ردود JSON متسقة ومنظمة جيدا
OAuth 2.1 + PKCE
دعوا مستخدميكم يربطون حساباتهم على yAppointment بتطبيقكم بأمان عبر مسار Authorization-Code مع PKCE — دون مشاركة كلمات المرور، وبصلاحيات محددة فقط.
- مسار Authorization-Code مع PKCE لوصول آمن مفوض من المستخدم
- صلاحيات دقيقة: read/write:bookings وread/write:customers
- الوصول إلى الملف الشخصي والتحليلات عبر read:profile وread:analytics
- إدارة webhooks عبر صلاحية webhooks:manage
- يمنح المستخدمون الوصول دون مشاركة بيانات الدخول أبدا
مفاتيح API للخادم وللاستخدام العام
أصدروا مفاتيح خادم (yapp_sk_*) لتكاملات الواجهة الخلفية ومفاتيح عامة (yapp_pk_*) للاستخدام من جهة العميل، مع بيئتي تشغيل واختبار منفصلتين تماما.
- مفاتيح خادم (yapp_sk_*) للاتصالات الموثوقة بين الخوادم
- مفاتيح عامة (yapp_pk_*) للاستخدام الآمن من جهة العميل
- بيئتا تشغيل واختبار منفصلتان للتطوير بثقة
- تغيير المفاتيح في أي وقت من لوحة التحكم
- الاختبار على بيانات تجريبية قبل الإطلاق
Webhooks موقعة
تلقوا إشعارا لحظة حدوث أي تغيير. يرسل yAppointment تسعة أنواع من الأحداث إلى نقاط HTTPS الخاصة بكم مع إعادة محاولة تلقائية وتتبع كامل للإرسال.
- 9 أنواع من الأحداث تغطي الحجوزات والعملاء والخدمات والموظفين
- أحداث booking.created وbooking.updated وbooking.cancelled
- نقاط استقبال عبر HTTPS فقط مع سر توقيع whsec_
- توقيعات HMAC-SHA256 في الترويسة yapp-signature
- إعادة محاولة تلقائية مع تتبع الإرسال، وإرسال تجريبي من لوحة التحكم
البدء
ابدؤوا البناء باستخدام SDK أو REST API في دقائق. الوثائق الكاملة والأمثلة التفاعلية على developers.yappointment.com.
عرض الوثائق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);مصممة لتجربة مطورين ممتازة
الأدوات والوثائق التي تجعل دمج yAppointment سريعا وممتعا
SDK بلغة TypeScript
استغنوا عن الشيفرة المتكررة مع SDK الرسمية بلغة TypeScript على npm — @lohisoftsro/yappointment-sdk — المولدة مباشرة من مواصفات OpenAPI، مع دعم ESM وCJS.
وثائق تفاعلية للمطورين
استكشفوا كل نقطة نهاية على developers.yappointment.com عبر مرجع Scalar API تفاعلي يمكنكم قراءته والبحث فيه وتجربته أثناء البناء.
وضعا التشغيل والاختبار
مفاتيح API منفصلة للتشغيل والاختبار تتيح لكم البناء والتجربة بأمان، ثم الانتقال إلى الإنتاج متى كنتم جاهزين — دون المساس بالبيانات الحقيقية.
إعادة محاولة آمنة
تجعل مفاتيح idempotency إعادة محاولة إنشاء الحجز آمنة، فلا تتحول أعطال الشبكة العابرة إلى مواعيد مكررة أبدا.
هل أنت مستعد لرؤية الفرق؟
14 يوما. وصول كامل. دون بطاقة ائتمان. لا شيء لتخسره.
استبدل أصحاب الأعمال في أنحاء أوروبا فوضى المهام الإدارية بمنصة واحدة تعمل ببساطة. انضم إليهم اليوم.
تجربة مجانية لمدة 14 يوما • دون عمولة — دائما • إلغاء في أي وقت