التصفيح

المعاملات

المعامل	النوع	الافتراضي	الحد الأقصى
page	صحيح (يبدأ من 1)	1	—
page_size	صحيح	20	1000

كلا المعاملين اختياريان. حذفهما يُعيد أول 20 نتيجة. القيم التي تتجاوز 1000 لـ page_size تُخفَّض بصمت إلى 1000.

التنقل بين الصفحات

استخدم count من غلاف الاستجابة لتحديد عدد الصفحات، ثم زد page حتى تحصل على جميع السجلات.

curl

# الصفحة الأولى
curl "https://staging.api.cms.itqan.dev/reciters/?page=1&page_size=10"

# الصفحة الثانية
curl "https://staging.api.cms.itqan.dev/reciters/?page=2&page_size=10"

Python

import urllib.request, urllib.parse, json

BASE = "https://staging.api.cms.itqan.dev"
PAGE_SIZE = 50

def fetch_all_reciters():
    results = []
    page = 1
    while True:
        params = urllib.parse.urlencode({"page": page, "page_size": PAGE_SIZE})
        url = f"{BASE}/reciters/?{params}"
        with urllib.request.urlopen(url) as resp:
            body = json.load(resp)
        results.extend(body["results"])
        if len(results) >= body["count"]:
            break
        page += 1
    return results

JavaScript

const BASE = "https://staging.api.cms.itqan.dev";
const PAGE_SIZE = 50;

async function fetchAllReciters() {
  const results = [];
  let page = 1;
  while (true) {
    const resp = await fetch(`${BASE}/reciters/?page=${page}&page_size=${PAGE_SIZE}`);
    const { count, results: items } = await resp.json();
    results.push(...items);
    if (results.length >= count) break;
    page++;
  }
  return results;
}

---

انظر أيضاً: هيكل الاستجابة · البحث والتصفية والترتيب · معالجة الأخطاء