البدء السريع للمطورين
طريقتان لاستخدام مكتبتك في Readsira من الكود، وهما REST API v2 وخادم MCP، ومن أين تبدأ.
المفاتيح والنطاقات والحدود
كيف تصادق على واجهة Readsira البرمجية، وما النطاقات الموجودة، وحدود كل خطة.
المصادقة ومفاتيح API
أنشئ مفتاح API، وأرسله مع الطلب، واختر النطاقات التي يحتاجها، وحافظ عليه آمنًا.
حدود المعدل والأخطاء
كيف يحد REST API من الطلبات، والترويسات التي يرسلها، وشكل الخطأ، ومعنى كل رمز خطأ.
ترقيم الصفحات
كيف تقرأ النتائج الطويلة صفحةً صفحةً باستخدام الإزاحات والمؤشرات وأرقام الصفحات.
Webhooks للمطورين
الأحداث التي يرسلها Readsira إلى خادمك، وحمولة كل منها، وكيفية التحقق من التوقيع في Node، وكيف تُعاد محاولات التسليم.
أمثلة
أربعة أمثلة عملية بـ curl وNode 18 أو أحدث، تحفظ رابطًا، وتقرأ تظليلات عنصر محفوظ، وتطرح سؤالًا موثقًا بالاستشهادات، وتزامن مكتبتك إلى ملف.
مرجع REST API v2
كل مسارات Readsira REST API v2: المعاملات وأجسام الطلبات والاستجابات والأخطاء، مولَّدة من الواجهة.