الحجوزات
اعرض الحجوزات وافحصها وصفِّها عبر ملاعبك، بما في ذلك حالة تسجيل الدخول.
المطوّرون
واجهة REST API مبنية لبيانات منشآت متعددة المستأجرين
ثلاث وعشرون نقطة نهاية مُصدَّرة تحت /api/v1. مصادقة Bearer، وصلاحيات محددة، وحدود معدل لكل رمز، وسجل تدقيق لكل استدعاء.
المصادقة
# Generate a token in Dashboard → Integrations.
# The secret is shown once and stored as a SHA-256 hash.
curl https://kourtiva.com/api/v1/me \
-H "Authorization: Bearer $KOURTIVA_TOKEN"
# 401 on an invalid, expired or revoked token.
# 403 when the token lacks the required ability.
# 429 once the rate limit is exceeded.أمان غير اختياري
- الأسرار مخزَّنة مجزّأة — تسريب قاعدة البيانات لا يمنح رمزاً صالحاً
- 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 }
]
}