جستجو و ارائه اخبار
خدمتدهنده
بازارچه پادیوم
مقدمه
وب سرویس جستجوی خبر محتوای بیش از ۱۰ سایت خبری را دریافت و خروجی را در قالب کل متن خبر و یا لینک محتوای اصلی و دیگر اطلاعات مرتبط با خبر ارائه میکند. کار این سرویس به نوعی خزش (crawl) محتوای سایتهای پر بازدید به شمار میآید و برای توسعهی محصولاتی مانند سرویسهای مطالعه خبر، سرویسهای رصد و تحلیل داده و کلیهی اپلیکیشنهای تخصصی که میخواهند اخبار مرتبط با حوزهی خود را هم در دسترس مخاطبین قرار دهند، مناسب است. برای مثال اپلیکیشنهای سرمایهگذاری و بورسی میتوانند به کمک این سرویس، در بخشی از اپلیکیشن خود تمام اخبار مرتبط با بورس را به کاربران نمایش دهند.
نکته:
با توجه به اینکه پادیوم صرفا واسط ارائه خدمت فیمابین ارائهدهنده اصلی خدمات و کاربر نهایی است، لذا هیچگونه مسئولیتی از حیث تضمین صحت، اصالت و اعتبار سرویس دریافتی توسط کاربر نهایی -شامل خبر یا اخبار- بر عهده نخواهد داشت. کاربر نهایی از این موضوع اطلاع داشته و حق هرگونه ادعا و اعتراض آتی در این خصوص را از خود سلب و ساقط مینماید.
فعالسازی سرویس
ارسال درخواست در سایت پادیوم www.podium.ir :
ابتدا وارد سایت پادیوم شده ، سپس در بازارچه ی API ، سرویسهای مورد نظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید.
درخواست شما توسط کارشناسان پادیوم، بررسی شده و بعد از تایید آن میتوانید از طربق پنل کسب و کار خود اقدام به دریافت کلید اتصال مربوط به آن سرویس نمایید.
منو: پنل کسب و کار – منوی میزکار سرویس گیرنده – درخواستهای ارسالی – در بخش مربوط به سرویس مورد نظر با کلیک بر روی "جزئیات درخواست"
درلیست باز شده با کلیک بر روی تصویر کلید سمت چپ هر سطر جدول میتوانید ApiKey مربوط به آن سرویس را دریافت و ذخیره کنید.
لینک پنل کسب و کار https://panel.pod.ir/Businesses/Requestwebservices
نکته : این کلید در تمام درخواستهای ارسالی از آن سرویس ، ثابت است تا زمانی که کلید جدیدی برای آن سرویس دریافت نشود و به محض دریافت مقدار جدید برای سرویس مورد نظر, کلید قبلی منقضی خواهد شد.
-این کلید در فیلد scApiKey در بخش body درخواست HTTP ، استفاده می شود.
دریافت کلیدهای سرویس یک (دسته/مجموعه) سرویس در قالب یک فایل:
بعداز فشردن دکمه ی تایید سرویس در پنجره باز شده بالا ، برای تمامی سرویسهای موجود در پنل میتوانید از گزینه "دریافت فایل خروجی"، لیست کاملی از سرویسها و کلیدهای scApiKey متناظر با هر یک را دریافت کنید.
سرویس ارائه خبر پادیوم
این سرویس اخبارهای گوناگونی از خبرگزاریها یا پرتالهای مختلف بر بستر API ارائه مینماید.
درحال حاضر خبرگزاری های پشتیبان شده بر روی این سرویس به شرح زیر میباشد
کد خبرگزاری | نام خبرگزاری |
1 | پیوست |
2 | راه پرداخت |
20 | سیتنا |
51 | چارسوپرس |
52 | شانا |
53 | تاریخ ایران |
54 | خبرگزاری آنا |
55 | پایگاه خبری آرتان پرس |
56 | ایانا |
57 | برق نیوز |
101 | ایلنا |
102 | تابناک |
103 | دیده بان ایران |
120 | ایونا |
از ابتدای سال 1402 خبرهای خبرگزاری های فوق بر روی این سرویس قرار گرفته است.
سرویس “پیوست” براساس دسترسی آزاد بر روی وب سرویس قرار گفته است و خبرها و موارد غیر رایگان بر روی این سرویس قرار نگرفته است. همچنین خبرهایی که شامل ویدیو و عکس می باشد بر روی سرویس قرار نگرفته است.
لیست خبرگزاری ها براساس اولویت کاربران گسترش می یابد و در صورتی که خبرگزاری خاصی مدنظر شماست می توانید با ارسال درخواست به پادیوم آن را در اولویت قرار دهیم.
دو سرویس برای این موضوع ارائه شده است که به شرح زیر می باشد
اخبار روز
شماره سرویس: 3890689
با استفاده از این سرویس شما می توانید اخبار روز جاری یک خبرگزاری را استخراج کنید. پارامترهای ورودی به شرح زیر می باشد
1 - NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد
2 – Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید
خروجی سرویس به شرح زیر میباشد.
- total: تعداد کل خبرهای روز را مشخص می سازد. در نمونه زیر 6 خبر یافت شده است.
- collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد
نام پارامتر | شرح |
url | آدرس خبر |
titlePage | عنوان مشخص شده در صفحه خبر (Title صفحه را مشخص می سازد) |
Subhead | رو تیتر خبر را مشخص می سازد. |
titleNews | عنوان خبر درج شده در صفحه را مشخص می سازد. |
Lead | لید خبر را مشخص می سازد. |
Body | متن خبر را مشخص می سازد |
shortLink | لینک کوتاه خبر را مشخص می سازد |
newsAgencyName | نام خبرگزاری را مشخص می سازد |
dateShamsi | تاریخ شمسی خبر را مشخص می سازد. فرمت خبر شامل 4 رقم سال، 2 رقم ماه و 2 رقم روز می باشد. برای نمونه تاریخ شمسی به صورت روبرو ارائه می شود 14010723 |
Date | تاریخ میلادی خبر را مشخص می سازد |
اخبار براساس یک تاریخ مشخص
شماره سرویس: 3890709
با استفاده از این سرویس شما می توانید اخبار تاریخ خاص از یک خبرگزاری را استخراج کنید. پارامترهای ورودی به شرح زیر می باشد
- NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد
- Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید
- date: تاریخ خبر را مشخص می سازید تا خبرهای آن تاریخ خاص برگردانده شود
خروجی سرویس به شرح زیر می باشد. (خروجی این دو سرویس کاملا یکسان می باشد)
- total: تعداد کل خبرهای روز را مشخص می سازد. در نمونه زیر 14 خبر یافت شده است. که چون صفحه دوم درخواست شده است تعداد خروجی سرویس 4 عدد می باشد.
- collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد
نام پارامتر | شرح |
Files | شامل یک آرایه می باشد که فایل های مربوط به این خبر را مشخص می سازد. |
url | آدرس خبر |
titlePage | عنوان مشخص شده در صفحه خبر (Title صفحه را مشخص می سازد) |
Subhead | رو تیتر خبر را مشخص می سازد. |
titleNews | عنوان خبر درج شده در صفحه را مشخص می سازد. |
Lead | لید خبر را مشخص می سازد. |
Body | متن خبر را مشخص می سازد |
shortLink | لینک کوتاه خبر را مشخص می سازد |
newsAgencyName | نام خبرگزاری را مشخص می سازد |
dateShamsi | تاریخ شمسی خبر را مشخص می سازد. فرمت خبر شامل 4 رقم سال، 2 رقم ماه و 2 رقم روز می باشد. برای نمونه تاریخ شمسی به صورت روبرو ارائه می شود 14010723 |
Date | تاریخ میلادی خبر را مشخص می سازد |
آخرین اخبار براساس یک خبرگزاری
شماره سرویس : 11481093
با استفاده از این سرویس شما می توانید آخرین اخبار از یک خبرگزاری را استخراج کنید. پارامترهای ورودی به شرح زیر می باشد
- NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد
- Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید
خروجی سرویس به شرح زیر می باشد. (خروجی این دو سرویس کاملا یکسان می باشد)
- total: تعداد کل خبرهای ثبت شده برای این خبرگزاری را مشخص می سازد. در نمونه زیر 3457 خبر یافت شده است.
- collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد
نام پارامتر | شرح |
url | آدرس خبر |
titlePage | عنوان مشخص شده در صفحه خبر (Title صفحه را مشخص می سازد) |
Subhead | رو تیتر خبر را مشخص می سازد. |
titleNews | عنوان خبر درج شده در صفحه را مشخص می سازد. |
Lead | لید خبر را مشخص می سازد. |
Body | متن خبر را مشخص می سازد |
shortLink | لینک کوتاه خبر را مشخص می سازد |
newsAgencyName | نام خبرگزاری را مشخص می سازد |
dateShamsi | تاریخ شمسی خبر را مشخص می سازد. فرمت خبر شامل 4 رقم سال، 2 رقم ماه و 2 رقم روز می باشد. برای نمونه تاریخ شمسی به صورت روبرو ارائه می شود 14010723 |
Date | تاریخ میلادی خبر را مشخص می سازد |
مثالی از خروجی سرویس:
تیتر اخبار یک خبرگزاری
شماره سرویس: 11481095
با استفاده از این سرویس شما می توانید تیتر اخبار از یک خبرگزاری را استخراج کنید. نکته مهم این است که در این سرویس بدنه خبر وجود ندارد و پارامترهای ورودی به شرح زیر می باشد
- NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد
- Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید
خروجی سرویس به شرح زیر می باشد.
- total: تعداد کل خبرهای ثبت شده برای این خبرگزاری را مشخص می سازد. در نمونه زیر 3457 خبر یافت شده است.
- collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد
نام پارامتر | شرح |
url | آدرس خبر |
titlePage | عنوان مشخص شده در صفحه خبر (Title صفحه را مشخص می سازد) |
Subhead | رو تیتر خبر را مشخص می سازد. |
titleNews | عنوان خبر درج شده در صفحه را مشخص می سازد. |
Lead | لید خبر را مشخص می سازد. |
shortLink | لینک کوتاه خبر را مشخص می سازد |
newsAgencyName | نام خبرگزاری را مشخص می سازد |
dateShamsi | تاریخ شمسی خبر را مشخص می سازد. فرمت خبر شامل 4 رقم سال، 2 رقم ماه و 2 رقم روز می باشد. برای نمونه تاریخ شمسی به صورت روبرو ارائه می شود 14010723 |
Date | تاریخ میلادی خبر را مشخص می سازد |
خبر کامل براساس کلید
شماره سرویس : 11481094
با استفاده از این سرویس شما میتوانید متن یک اخبار با استفاده از کلید استخراج کنید. و پارامترهای ورودی به شرح زیر می باشد.
این سرویس جهت دریافت متن کامل خبر با استفاده از کلید می باشد؛ استفاده از این سرویس بعد از فراخوانی سرویس تیتر خبرها پیشنهاد می شود.
Id: کد شناسه را مشخص می سازد.
خروجی سرویس به شرح زیر می باشد:
- total: تعداد کل خبرهای ثبت شده برای این خبرگزاری را مشخص می سازد. در نمونه زیر 3457 خبر یافت شده است.
- item: در این بخش خبر به صورت یک object شامل فیلدهای زیر می باشد
نام پارامتر | شرح |
Files | شامل یک آرایه می باشد که فایل های مربوط به این خبر را مشخص می سازد. |
url | آدرس خبر |
titlePage | عنوان مشخص شده در صفحه خبر (Title صفحه را مشخص می سازد) |
subhead | رو تیتر خبر را مشخص می سازد. |
titleNews | عنوان خبر درج شده در صفحه را مشخص می سازد. |
Lead | لید خبر را مشخص می سازد. |
body | بدنه خبر را مشخص می سازد |
shortLink | لینک کوتاه خبر را مشخص می سازد |
newsAgencyName | نام خبرگزاری را مشخص می سازد |
dateShamsi | تاریخ شمسی خبر را مشخص می سازد. فرمت خبر شامل 4 رقم سال، 2 رقم ماه و 2 رقم روز می باشد. برای نمونه تاریخ شمسی به صورت روبرو ارائه می شود 14010723 |
date | تاریخ میلادی خبر را مشخص می سازد |