الحجوزات
اعرض الحجوزات وافحصها وصفِّها عبر ملاعبك، بما في ذلك حالة تسجيل الدخول.
المطوّرون
واجهة REST API مبنية لبيانات منشآت متعددة المستأجرين
ثلاث وعشرون نقطة نهاية مُصدَّرة تحت /api/v1. مصادقة Bearer، وصلاحيات محددة، وحدود معدل لكل رمز، وسجل تدقيق لكل استدعاء.
المصادقة
# أنشئ رمزًا من لوحة التحكم ← التكاملات.
# يظهر المفتاح السري مرة واحدة ويُخزَّن كتجزئة SHA-256.
curl https://kourtiva.com/api/v1/me \
-H "Authorization: Bearer $KOURTIVA_TOKEN"
# 401 عند استخدام رمز غير صالح أو منتهي الصلاحية أو ملغى.
# 403 عندما يفتقر الرمز إلى الصلاحية المطلوبة.
# 429 عند تجاوز حد الطلبات.أمان غير اختياري
- الأسرار مخزَّنة مجزّأة — تسريب قاعدة البيانات لا يمنح رمزاً صالحاً
- HTTPS إلزامي، ويُرفض HTTP العادي بدل إعادة توجيهه
- صلاحيات لكل رمز، فلا يستطيع تكامل تقارير الكتابة
- تواريخ انتهاء اختيارية، وإلغاء يسري فوراً
- المستأجر يُحدَّد على الخادم — ولا يُقبل معرّف منشأة من العميل أبداً
- تُسجَّل الطريقة والمسار والحالة والمدة والرمز لكل طلب
الموارد
ما يمكنك قراءته وكتابته
الملاعب والفترات
تعريفات الملاعب وفتراتها القابلة للحجز، مع التوافر حسب التاريخ.
الرياضات والمرافق
الرياضات التي تقدّمها والمرافق المرتبطة بكل منشأة.
الأعضاء
اللاعبون المسجّلون في منشأتك مع سجل حجوزاتهم.
الفواتير والمدفوعات
سجلات مالية مرتبطة بالحجوزات التي أنتجتها.
البطولات
المسابقات والفرق المسجّلة والمباريات.
الزوار
أعداد الزوار وملخصاتها لتقارير الإشغال.
ملف المنشأة
سجل منشأتك — المستأجر الذي يشير إليه الرمز.
مُصدَّرة بإصدارات، فالترقيات تجدولها أنت
كل شيء تحت /api/v1. التغييرات الكاسرة تصدر كإصدار جديد بدل أن تصل دون إنذار في الإصدار الذي تكاملت معه.
اطلب الوصول إلى الـAPI توافر الملاعب
GET /api/v1/courts/12/slots?date=2026-08-09
{
"data": [
{ "starts_at": "08:00", "available": true },
{ "starts_at": "09:00", "available": false },
{ "starts_at": "10:00", "available": true }
]
}