جستجو و ارائه اخبار

مقدمه

وب سرویس جستجوی خبر محتوای بیش از ۱۰ سایت خبری را دریافت و خروجی را در قالب کل متن خبر و یا لینک محتوای اصلی و دیگر اطلاعات مرتبط با خبر ارائه می‌کند. کار این سرویس به نوعی خزش (crawl) محتوای سایت‌های پر بازدید به شمار می‌آید و برای توسعه‌ی محصولاتی مانند سرویس‌های مطالعه خبر، سرویس‌های رصد و تحلیل داده‌ و کلیه‌ی اپلیکیشن‌های تخصصی که می‌خواهند اخبار مرتبط با حوزه‌ی خود را هم در دسترس مخاطبین قرار دهند، مناسب است. برای مثال اپلیکیشن‌های سرمایه‌گذاری و بورسی می‌توانند به کمک این سرویس، در بخشی از اپلیکیشن خود تمام اخبار مرتبط با بورس را به کاربران نمایش دهند. 

نکته:
با توجه به اینکه پادیوم صرفا واسط ارائه خدمت فی‌مابین ارائه‌دهنده اصلی خدمات و کاربر نهایی است، لذا هیچگونه مسئولیتی از حیث تضمین صحت، اصالت و اعتبار سرویس دریافتی توسط کاربر نهایی -شامل خبر یا اخبار- بر عهده نخواهد داشت. کاربر نهایی از این موضوع اطلاع داشته و حق هرگونه ادعا و اعتراض آتی در این خصوص را از خود سلب و ساقط می‌نماید.

 فعالسازی سرویس

ارسال درخواست در سایت پادیوم www.podium.ir  :

ابتدا وارد سایت پادیوم شده ، سپس در بازارچه ی API ، سرویسهای مورد نظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید.

درخواست شما توسط کارشناسان پادیوم، بررسی شده و بعد از تایید آن می‌توانید از طربق پنل کسب و کار خود اقدام به دریافت کلید اتصال مربوط به آن سرویس نمایید.

منو: پنل کسب و کار – منوی میزکار سرویس گیرنده – درخواستهای ارسالی – در بخش مربوط به سرویس مورد نظر با کلیک بر روی "جزئیات درخواست"

درلیست باز شده با کلیک بر روی تصویر کلید سمت چپ هر سطر جدول می‌توانید ApiKey مربوط به آن سرویس را دریافت و ذخیره کنید.

لینک پنل کسب و کار                                                                                                                                                                                     https://panel.pod.ir/Businesses/Requestwebservices

نکته : این کلید در تمام درخواست‌های ارسالی از آن سرویس ، ثابت است تا زمانی که کلید جدیدی برای آن سرویس دریافت نشود و به محض دریافت مقدار جدید برای سرویس مورد نظر, کلید قبلی منقضی خواهد شد.

-این کلید در فیلد scApiKey در بخش body درخواست HTTP ، استفاده می شود.

دریافت کلیدهای سرویس یک (دسته/مجموعه) سرویس در قالب یک فایل:

بعداز فشردن دکمه ی تایید سرویس در پنجره باز شده بالا ، برای تمامی سرویسهای موجود در پنل می‌توانید از گزینه "دریافت فایل خروجی"، لیست کاملی از سرویس‌ها و کلیدهای scApiKey متناظر با هر یک را دریافت کنید.

سرویس ارائه خبر پادیوم

این سرویس اخبارهای گوناگونی از خبرگزاری‌ها یا پرتال‌های مختلف بر بستر API ارائه می‌نماید.

درحال حاضر خبرگزاری های پشتیبان شده بر روی این سرویس به شرح زیر می‌باشد

از ابتدای سال 1402 خبرهای خبرگزاری های فوق بر روی این سرویس قرار گرفته است.

سرویس “پیوست” براساس دسترسی آزاد بر روی وب سرویس قرار گفته است و خبرها و موارد غیر رایگان بر روی این سرویس قرار نگرفته است. همچنین خبرهایی که شامل ویدیو و عکس می باشد بر روی سرویس قرار نگرفته است.

لیست خبرگزاری ها براساس اولویت کاربران گسترش می یابد و در صورتی که خبرگزاری خاصی مدنظر شماست می توانید با ارسال درخواست به پادیوم آن را در اولویت قرار دهیم.

دو سرویس برای این موضوع ارائه شده است که به شرح زیر می باشد

اخبار روز

شماره سرویس: 3890689

با استفاده از این سرویس شما می توانید اخبار روز جاری یک خبرگزاری را استخراج کنید. پارامترهای ورودی به شرح زیر می باشد

1 -  NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد

2 – Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید

خروجی سرویس به شرح زیر می‌باشد.

1. total: تعداد کل خبرهای روز را مشخص می سازد. در نمونه زیر 6 خبر یافت شده است.
2. collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد

اخبار براساس یک تاریخ مشخص

شماره سرویس: 3890709

با استفاده از این سرویس شما می توانید اخبار تاریخ خاص از یک خبرگزاری را استخراج کنید. پارامترهای ورودی به شرح زیر می باشد

1. NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد
2. Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید
3.  date: تاریخ خبر را مشخص می سازید تا خبرهای آن تاریخ خاص برگردانده شود

خروجی سرویس به شرح زیر می باشد. (خروجی این دو سرویس کاملا یکسان می باشد)

1. total: تعداد کل خبرهای روز را مشخص می سازد. در نمونه زیر 14 خبر یافت شده است. که چون صفحه دوم درخواست شده است تعداد خروجی سرویس 4 عدد می باشد.
2.  collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد

 آخرین اخبار براساس یک خبرگزاری

شماره سرویس : 11481093

با استفاده از این سرویس شما می توانید آخرین اخبار از یک خبرگزاری را استخراج کنید. پارامترهای ورودی به شرح زیر می باشد

1. NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد
2. Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید

خروجی سرویس به شرح زیر می باشد. (خروجی این دو سرویس کاملا یکسان می باشد)

1. total: تعداد کل خبرهای ثبت شده برای این خبرگزاری را مشخص می سازد. در نمونه زیر 3457 خبر یافت شده است.
2. collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد

مثالی از خروجی سرویس:

تیتر اخبار یک خبرگزاری

شماره سرویس: 11481095

با استفاده از این سرویس شما می توانید تیتر اخبار از یک خبرگزاری را استخراج کنید. نکته مهم این است که در این سرویس بدنه خبر وجود ندارد و پارامترهای ورودی به شرح زیر می باشد

1. NewsAgencyId: این کد خبرگزاری را مشخص می سازد که از جدول مشخص شده قابل دریافت می باشد
2. Page: در هر صفحه تعداد 10 خبر برگردانده می شود و صفحه آغازین مقدار یک می باشد. در صورتی که تعداد خبرهای روز جاری از 10 بیشتر باشد؛ می توان با مقادیر بیشتر از یک به خبرهای بعدی دسترسی داشته باشید

خروجی سرویس به شرح زیر می باشد.

1. total: تعداد کل خبرهای ثبت شده برای این خبرگزاری را مشخص می سازد. در نمونه زیر 3457 خبر یافت شده است.
2. collection: در این بخش خبرها به صورت یک آرایه قابل دریافت می باشد. این object شامل فیلدهای زیر می باشد

 خبر کامل براساس کلید

شماره سرویس : 11481094

با استفاده از این سرویس شما می‎توانید متن یک اخبار با استفاده از کلید استخراج کنید. و پارامترهای ورودی به شرح زیر می باشد.

این سرویس جهت دریافت متن کامل خبر با استفاده از کلید می باشد؛ استفاده از این سرویس بعد از فراخوانی سرویس تیتر خبرها پیشنهاد می شود.

Id: کد شناسه را مشخص می سازد.

خروجی سرویس به شرح زیر می باشد:

1. total: تعداد کل خبرهای ثبت شده برای این خبرگزاری را مشخص می سازد. در نمونه زیر 3457 خبر یافت شده است.
2.  item: در این بخش خبر به صورت یک object شامل فیلدهای زیر می باشد