کردپرس · Developers
دسترسی JSON اخبار از API باز خبر کردپرس — بدون کلید، فقط خواندنی. فهرست، فیلتر دسته و جزئیات خبر برای مانیتورینگ، ربات‌ها و پروژه‌های دیتاساینس.
سه الگوی رایج؛ دکمه کپی برای هر نمونه فعال است.
curl -s "https://www.kurdpress.com/api/v1/open/news?locale=fa&page=1"
curl -s "https://www.kurdpress.com/api/v1/open/news?locale=fa&category=news-fa"
curl -s "https://www.kurdpress.com/api/v1/open/news/2801917?locale=fa"
با انتخاب زبان، نمونه‌های curl به‌روز می‌شوند.
slug واقعی از پایگاه؛ کلیک، فیلتر دسته را در نمونه curl می‌نویسد.
curl -s "https://www.kurdpress.com/api/v1/open/news?locale=fa&category=news-fa"
پایه: https://www.kurdpress.com/api/v1/open
| روش | مسیر | توضیح | Throttle |
|---|---|---|---|
GET |
/news |
فهرست اخبار منتشرشده | ۳۰ / دقیقه / IP |
GET |
/news/{id} |
جزئیات یک خبر (شامل content) | ۲۰ / دقیقه / IP |
GET |
/categories |
دسته‌های فعال برای فیلتر | ۳۰ / دقیقه / IP |
locale — کد زبان فعالcategory — slug یا id دستهpage — ۱ تا ۵۰۰after_id — cursor؛ اگر باشد بر page اولویت داردper_page — پذیرفته نمی‌شود؛ همیشه حداکثر ۱۰ آیتماگر اپ یا سایتی بر پایه این API ساخته‌اید، می‌توانید برای دمو لینک کنید تا اینجا نمایش داده شود.
Base URL را کپی کنید، سپس GET /news?locale=fa&page=1 را صدا بزنید. برای فیلتر، category را با slug دسته اضافه کنید. جزئیات هر خبر با /news/{id} در دسترس است.
هر پاسخ فهرست حداکثر ۱۰ خبر برمی‌گرداند. per_page پذیرفته نمی‌شود.
خیر. این Open News API عمومی و فقط‌خواندنی است؛ بدون احراز هویت کار می‌کند.
محدودیت نرخ بر اساس IP است: فهرست و دسته‌ها حدود ۳۰ درخواست در دقیقه، جزئیات حدود ۲۰ درخواست در دقیقه.
RSS برای فیدخوان‌ها و اشتراک ساده مناسب است. API JSON فیلتر locale/دسته، صفحه‌بندی/cursor و جزئیات کامل‌تر (از جمله content در اندپوینت detail) می‌دهد.
خروجی تحت CC BY-NC-ND 4.0 است: نسبت‌دهی الزامی، استفاده تجاری بازنشر بدون مجوز جداگانه ممنوع، و مشتق‌سازی متن خبر مجاز نیست.
خروجی این API تحت CC BY-NC-ND 4.0 ارائه می‌شود.
سوءاستفاده (اسکرپینگ تهاجمی، دور زدن throttle) ممکن است به محدودیت IP منجر شود.