API رایگان و متنباز برای دسترسی به گنجینهای از اشعار شاعران بزرگ فارسی
برای دریافت یک شعر تصادفی:
curl https://pq.arsamadineh.ir/api/quotes?random=true&limit=1🎉 احراز هویت لازم نیست!
این API کاملاً عمومی است و نیازی به کلید API، توکن یا هر نوع احراز هویت ندارد. فقط کافی است درخواستهای HTTP ارسال کنید.
| پارامتر | نوع | پیشفرض | توضیحات |
|---|---|---|---|
| limit | عدد | 10 | تعداد اشعار (حداکثر 100) |
| random | boolean | false | انتخاب تصادفی اشعار |
| poet | رشته | - | فیلتر بر اساس نام شاعر |
| category | رشته | - | فیلتر بر اساس دستهبندی |
# دریافت 5 شعر تصادفی
GET /api/quotes?random=true&limit=5
# دریافت اشعار حافظ
GET /api/quotes/حافظ شیرازی
# دریافت اشعار عاشقانه
GET /api/quotes/category/عشق| پارامتر | نوع | توضیحات |
|---|---|---|
| q | رشته | کلمه یا عبارت جستجو (حداقل 2 کاراکتر) |
| limit | عدد | تعداد نتایج (حداکثر 50) |
| lang | رشته | زبان جستجو: persian, english, both |
GET /api/quotes/search?q=عشق&limit=10&lang=persianپارامتر stats=true برای دریافت تعداد اشعار هر شاعر
شامل دستهبندیهایی مثل: عشق، عرفان، حکمت، طبیعت، زندگی
API از کدهای استاندارد HTTP برای نشان دادن موفقیت یا شکست درخواستها استفاده میکند:
{
"error": "No quotes found for this poet",
"poet": "شاعر نامعلوم"
}// دریافت شعر تصادفی
async function getRandomQuote() {
try {
const response = await fetch('/api/quotes?random=true&limit=1');
const data = await response.json();
if (data.success) {
console.log(data.data[0].text_persian);
console.log('- ' + data.data[0].poet);
}
} catch (error) {
console.error('خطا در دریافت شعر:', error);
}
}
// جستجو در اشعار
async function searchQuotes(query) {
const response = await fetch(`/api/quotes/search?q=${encodeURIComponent(query)}`);
const data = await response.json();
return data.data;
}