للمطورين

التوثيق التقني

كل ما تحتاجه لربط نظامك بـ API كاليماخوس — مصادقة، endpoints، وأمثلة عملية

🚀 البدء السريع

API كاليماخوس RESTful يعمل على HTTPS. كل دار نشر لها endpoint مستقل.

Base URL: https://{subdomain}.kallimachos.com/api/v1/

🔐 المصادقة

نستخدم نظام Bearer Token + HMAC Signature لكل طلب:

Authorization: Bearer {api_token}
X-Timestamp: {unix_timestamp}
X-Signature: {hmac_sha256_signature}

يمكن توليد مفاتيح API من لوحة التحكم ← إعدادات ← مفاتيح API

📚 الكتب — Books

GET /books قائمة الكتب مع فلاتر: stage, search, page
GET /books/{id} تفاصيل كتاب واحد كاملة
POST /books إنشاء كتاب جديد
PUT /books/{id} تحديث بيانات كتاب

التوثيق الكامل متاح للمشتركين في خطة المحترف والمؤسسات

ابدأ مع خطة المحترف ←