البداية السريعة

يمنحك Itqan CMS API بيانات قرآنية موثوقة — قراء، تلاوات، روايات، قراءات، وتوقيتات صوتية على مستوى الآية — من ناشرين معتمدين، عبر واجهة REST/JSON نظيفة. بلا SDK وبلا إعداد: كل نقطة نهاية هي طلب GET بسيط يمكنك تشغيله من الطرفية الآن.

طلبك الأول

الوقت: ~30 ثانية. انسخ، الصق، نفّذ — لا حاجة لمفتاح API لقراءة المحتوى العام.

عنوان URL الأساسي: https://staging.api.cms.itqan.dev

اعرض القراء المتاحين في الفهرس:

curl

curl https://staging.api.cms.itqan.dev/reciters/

Python

import urllib.request
import json

with urllib.request.urlopen("https://staging.api.cms.itqan.dev/reciters/") as resp:
    data = json.load(resp)

print(f"إجمالي القراء: {data['count']}")
for reciter in data["results"]:
    print(f"  {reciter['name']} — {reciter['recitations_count']} تلاوة")

JavaScript

const resp = await fetch("https://staging.api.cms.itqan.dev/reciters/");
const { count, results } = await resp.json();

console.log(`إجمالي القراء: ${count}`);
results.forEach((r) => console.log(`  ${r.name} — ${r.recitations_count} تلاوة`));

الاستجابة:

{
  "count": 42,
  "results": [
    {
      "id": 1,
      "name": "مشاري راشد العفاسي",
      "bio": "...",
      "recitations_count": 3
    }
  ]
}

هذا تكامل حيّ. تريد العربية بدلاً من ذلك؟ أضف -H "Accept-Language: ar" فتعود كل حقول name وdescription وbio مُوطَّنة.

← مرجع كامل للنقطة: قائمة القراء

مصمَّم بعناية للمطورين

• اعرض من طلب واحد. الموارد المرتبطة مُضمَّنة ككائنات مضغوطة {id, name}، فتحمل الاستجابة الواحدة كل ما تحتاجه لعرض عنصر قائمة كامل. ← الموارد المرتبطة
• حقل واحد، أي لغة. اطلب العربية أو الإنجليزية عبر ترويسة Accept-Language — مفاتيح JSON لا تتغير أبداً، تتغير القيم فقط. ← التوطين
• أشكال ثابتة ومتوقعة. مسارات بأسماء جمع، وغلاف {count, results} متسق، وصيغة أخطاء موحدة تجعل كتابة العملاء سهلة. ← مبادئ التصميم
• آمن للبناء عليه. معرّفات الموارد أعداد صحيحة ثابتة، والـ API يتطور إضافياً — الحقول الجديدة لا تكسر التكاملات القائمة.

ما التالي؟

• مرجع الـ API — جميع نقاط النهاية مع أمثلة تفاعلية
• مبادئ التصميم — الاتفاقيات وراء الـ API
• معالجة الأخطاء — بناء عملاء متينين