دیوار پادکست فارسی

مستندات رابط کاربری برنامه نویسی دیوار پادکست فارسی

مانیفیست

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

احراز هویت

احراز هویت اپلیکیشن:

هر درخواست ارسالی باید شاملX-App-Token در هدر باشد. برای دریافت توکن خود این فرم را پر کنید، پس از بررسی درخواست شما، توکن اختصاصی برای شما ارسال خواهد شد.

احراز هویت کاربر:

احراز هویت کاربران در Api از طریق jwtانجام میپذیرد. بعد از لاگین هر کاربر شما به jwt آن یوزر دسترسی خواهید داشت. سپس میتوانید در هدر هر درخواست کلید Authorization با فرمت Bearer <JWT>ارسال کنید.

لاگین در دیوار پادکست فارسی از طریق سرویس احراز هویت گوگل صورت میپریزد. id_token گوگل را به عنوان یک پارامتر در API ارسال کنید، API به شما اطلاعات کاربر و JWT را برخواهد گرداند.

post
login

http://wall.hezaro.com/api/v1/login
Request
Response
Path Parameters
id_token
required
string
Id_token that google sdk gives you.
Headers
X-App-Token
required
string
Application token
200: OK
کاربر با موفقیت ثبت شد.
{
"meta": {
"status": 200,
"message": ""
},
"response": {
"username": "yahya",
"email": "yahyaarbabi@gmail.com",
"jwt": "<JWT Token>"
}
}
422: Unprocessable Entity
توکن شما معتبر نیست.
{
"meta": {
"status": 422,
"message": "خطا در فرایند لاگین"
}
}

نسخه بندی اپلیکیشن

این آدرس نسخه فعلی اپلیکیشن شما که در دیتابیس ما برای شما ثبت شده است را برمیگرداند. تا اگر نسخه فعلی کاربر، نسخه‌ي متفاوتی از آخرین نسخه ثبت شده بود، بتوانید درخواست به روزرسانی را برای کاربر ارسال کنید. این پایانه در حال حاضر صرفا برای خواندن آخرین ورژن استفاده میشود. برای تغییر در آخرین ورژن خود باید با ما تماس بگیرید.

get
Version

http://wall.hezaro.com/api/v1/version
Request
Response
Headers
X-App-Token
required
string
Application Token
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": {
"version": "0.1.1",
"force_update": false
}
}

درخواست اطلاعات کاربر

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

get
Profile

http://wall.hezaro.com/api/v1/profile
Request
Response
Headers
Authorization
required
string
Bearer <jwt>
X-App-Token
required
string
Application Token
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": {
"id": 1,
"username": "yahyaarbabi",
"display_name": "Yahya SayadArbabi",
"email": "yahyaarbabi@gmail.com",
"avatar": "http://wall.hezaro.com/static/assets/img/avatar.jpeg"
}
}

دریافت لیست اپیزودها

این پایانه به شما لیست اپیزودهای دیوار پادکست فارسی را برمیگرداند. مثل هر پایانه استاندارد دیگری شما میتواند با تعیین offset از pagination استفاده کنید. همچنین میتوانید از پارامتر sort_by اپیزودها را به ترتیب رای کاربران (بهترینها) یا زمان انتشار دریافت کنید.

با هدف خلاصه سازی، پارامترهای هدر از این پس در راهنمای پایانه‌ها ذکر نمیشود مگر این که تغییری در آنها رخ داه باشد.

get
Episodes

http://wall.hezaro.com/api/v1/episodes
Request
Response
Query Parameters
sort_by
optional
string
Use last for latest and best for the bests.
offset
optional
number
how many episode each page have?
page
optional
number
How many page you want to retrive?
200: OK
{
"meta": {
"status": 200
},
"response": [
{
"id": 2196,
"title": " سی و نه - من کشته خواهم شد",
"description": "جزئیات",
"creator": null,
"votes": 0,
"view": 0,
"poster": "http://localhost:8000/media/poster/2196.jpg",
"source": "https://media.blubrry.com/channelb/content.blubrry.com/channelb/ChannelB_Podcast_Episode_39.mp3",
"published_at": "2018-07-21T19:56:00Z",
"published_at_jalali": "۳۰ تیر ۱۳۹۷ ",
"comments_count": 0,
"podcast": {
"id": 4,
"title": "channelb",
"website": "",
"creator": null
}
},
{
"id": 2197,
"title": "سی و هشت - کشتی نوح",
"description": "توضیحات پادکست",
"creator": null,
"votes": 0,
"view": 0,
"poster": "http://localhost:8000/static/assets/img/mic.jpg",
"source": "https://media.blubrry.com/channelb/content.blubrry.com/channelb/ChannelB_Podcast_Episode_38.mp3",
"published_at": "2018-07-07T17:32:00Z",
"published_at_jalali": "۱۶ تیر ۱۳۹۷ ",
"comments_count": 0,
"podcast": {
"id": 4,
"title": "channelb",
"website": "",
"creator": null
}
}
]
}

دریافت یک اپیزود خاص

این پایانه با دریافت آی دی یک اپیزود تنها آن اپیزود را برخواهد گرداند.

get
Episodes/id

http://wall.hezaro.com/api/v1/episodes/{id}
Request
Response
Path Parameters
id
required
number
Episode id
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": {
"id": 240,
"title": "بیست و دو: از کیم جونگ اون عکس نگیر",
"description": "<p>کیم جونگ اون، رهبر کره شمالی عکاس شخصی خود را اخراج کرد. این عکاس متهم شد که هنگام برگزاری انتخابات در کره شمالی تصویری نامناسب که در شان رهبر کره شمالی نبوده، گرفته و عظمت رهبری وی را زیر سوال برده است. در این پادکست از زندگی و سرنوشت این عکاس می‌گوییم.</p>\n<p>مقاله <a rel=\"nofollow\" href=\"https://www.digimage.ir/kim/\">بیست و دو: از کیم جونگ اون عکس نگیر</a> در وب‌سایت <a rel=\"nofollow\" href=\"https://www.digimage.ir\">دیج ایمیج - digimage</a> منتشر شد.</p>\n",
"creator": "",
"likes_count": 1,
"views_count": 3,
"is_liked": true,
"is_bookmarked": false,
"cover": "http://example.com/static/assets/img/mic.png",
"source": "https://digimage.ir/podcast/22_Kim.mp3",
"length": 39008137,
"duration": "",
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1557206783.0,
"comments_count": 0,
"podcast": {
"id": 4,
"title": "دیج ایمیچ",
"website": "",
"creator": "",
"episodes_count": 20,
"cover": "https://www.digimage.ir/wp-content/uploads/2018/01/cropped-Digimage-Favicon-0۱-32x32.png"
}
}
}

دریافت لیست پادکست ها

در این پایانه میتوانید لیست پادکست‌های فارسی را دریافت کنید.

به لیبلهایی که اپیزود منتشر میکنند، پادکست میگوییم و به هر قسمت منتشر شده یک اپیزود. مثلا چنل بی یک پادکست است و دارو دسته نخبگان عضلانی یک اپیزود است که توسط چنل بی منتشر شده است.

get
Podcasts

http://wall.hezaro.com/api/v1/podcasts
Request
Response
Query Parameters
page
optional
number
offset
optional
number
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": [
{
"id": 1,
"title": "استارت‌باکس",
"website": "http://startboxpodcast.com",
"creator": "صدرا علی‌ابادی",
"episodes_count": 3
},
{
"id": 2,
"title": "پادکست بوم",
"website": "https://t.me/BoomPodcast",
"creator": "",
"episodes_count": 15
},
{
"id": 3,
"title": "تاریخ تازه‌ها",
"website": "http://fa.rfi.fr/emission/info/%D8%AA%D8%A7%D8%B1%DB%8C%D8%AE-%D8%AA%D8%A7%D8%B2%D9%87%E2%80%8C%D9%87%D8%A7",
"creator": "rfi",
"episodes_count": 207
},
{
"id": 4,
"title": "دستان ۱۱۸",
"website": "http://www.dastan118.ir/",
"creator": "گروه فرهنگی دستان ۱۱۸",
"episodes_count": 26
},
{
"id": 5,
"title": "رادیو دستنوشته‌ها",
"website": "https://soundcloud.com/radiodastneveshteha",
"creator": "محمود عظیمایی",
"episodes_count": 25
},
{
"id": 6,
"title": "پادکست ساگا",
"website": "https://t.me/sagapodcast",
"creator": "حسین رضوی",
"episodes_count": 14
},
{
"id": 7,
"title": "شعر و ادبیات پارسی",
"website": "http://www.tripira.com/",
"creator": "فرشید و فرزاد",
"episodes_count": 47
},
{
"id": 8,
"title": "فردوسی خوانی",
"website": "https://readingferdowsi.com/",
"creator": "امیرخادم",
"episodes_count": 67
},
{
"id": 9,
"title": "پادکست لوگوس",
"website": "https://t.me/logos_podcast",
"creator": "حامد قدیری",
"episodes_count": 18
},
{
"id": 10,
"title": "پادکست پاراگراف",
"website": "https://paragraph.podbean.com/",
"creator": "علیرضا بنی‌جانی",
"episodes_count": 9
}
]
}

دریافت اطلاعات یک پادکست خاص

در این پایانه میتوانید با داشتن آی دی یک پادکست اطلاعات آن را دریافت کنید.

get
Podcasts/id

http://wall.hezaro.com/api/v1/podcasts/{id}
Request
Response
Path Parameters
id
required
string
Id of podcast
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": {
"id": 1,
"title": "استارت‌باکس",
"description": "استارت باکس پادکستیه که تو هر قسمتش، خلاصه یه کتاب مهم تو حوزه‌ی استارت آپ رو تعریف میکنیم.",
"website": "http://startboxpodcast.com",
"creator": "صدرا علی‌ابادی",
"episodes_count": 3,
"cover": "http://wall.hezaro.com/media/poster/podcast_1.jpg"
}
}

دریافت اپیزودهای یک پادکست خاص

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

get
podcasts/id/episodes

http://wall.hezaro.com/api/v1/podcasts/{podcast_id}/episodes
Request
Response
Path Parameters
podcasts_id
required
string
id of a podcast label
Query Parameters
page
optional
number
offset
optional
number
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": [
{
"id": 260,
"title": "سه‌ : مقیاس ناپذیر باش!",
"description": "<p>متن پادکست :</p>\n<p>sadraa.me/ds</p>\n<p>مقاله پاول گراهام:</p>\n<p>http://paulgraham.com/ds.html</p>\n<p>وبسایت do things that don't scale:</p>\n<p>https://www.dothingsthatdontscale.com/</p>\n<p><br></p>\n<p>رپ فری استایل موسس دیزاین پیکل:</p>\n<p>https://www.facebook.com/designpickle/videos/second-attempt-to-freestyle-raps-for-annual-upgrades/1637686729622912/</p>",
"creator": "",
"likes_count": 0,
"views_count": 1,
"is_liked": false,
"is_bookmarked": false,
"cover": "http://example.com/media/poster/260.jpg",
"source": "https://anchor.fm/s/8d5e6e0/podcast/play/2962992/https%3A%2F%2Fd3ctxlq1ktw2nl.cloudfront.net%2Fproduction%2F2019-3-17%2F12956837-22050-2-10720e39f5b25.mp3",
"length": 31661625,
"duration": 1892,
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1555507140.0,
"comments_count": 0,
"podcast": {
"id": 1,
"title": "startbox",
"website": "http://startboxpodcast.com",
"creator": "صدرا علی‌آبادی",
"episodes_count": 3,
"cover": "https://s3-us-west-2.amazonaws.com/anchor-generated-image-bank/production/podcast_uploaded/1382360/1382360-1548659312029-eaba173a64cc4.jpg"
}
},
{
"id": 282,
"title": "(Lean StartUp)یک : خلاصه کتاب لین استارت آپ ",
"description": "<p>توی این قسمت در مورد کتاب لین استارت اپ صحبت میکنیم.</p>\n<p><br></p>\n<p>لینک وبسایت پادکست:</p>\n<p>startboxpodcast.com</p>\n<p>شتابدهنده هاب:</p>\n<p>mcihubacc.com</p>\n<p>وبلاگ میزبان:</p>\n<p>sadraa.me</p>\n<p><br></p>\n<p>سخنرانی آقای ریس در گوگل :</p>\n<p>https://www.youtube.com/watch?v=fEvKo90qBns</p>\n<p><br></p>\n<p>کتاب تست مامان:</p>\n<p>https://www.pingon.io/books/mom-test/fa</p>",
"creator": "",
"likes_count": 0,
"views_count": 1,
"is_liked": false,
"is_bookmarked": false,
"cover": "http://example.com/media/poster/282.jpg",
"source": "https://anchor.fm/s/8d5e6e0/podcast/play/2205184/https%3A%2F%2Fd3ctxlq1ktw2nl.cloudfront.net%2Fproduction%2F2019-0-27%2F8921876-48000-2-d0e8a7792130e.mp3",
"length": 26052034,
"duration": 1569,
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1548587581.0,
"comments_count": 0,
"podcast": {
"id": 1,
"title": "startbox",
"website": "http://startboxpodcast.com",
"creator": "صدرا علی‌آبادی",
"episodes_count": 3,
"cover": "https://s3-us-west-2.amazonaws.com/anchor-generated-image-bank/production/podcast_uploaded/1382360/1382360-1548659312029-eaba173a64cc4.jpg"
}
}
]
}o

دسته‌بندی‌ها

get
Categories

http://wall.hezaro.com/api/v1/categories
Request
Response
Path Parameters
optional
string
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": [
{
"id": 2,
"title": "Technology",
"title_fa": "تکنولوژی",
"background": "http://wall.hezaro.com/static/assets/img/category-bg.jpg",
"count": 19,
"description": ""
},
{
"id": 9,
"title": "Music",
"title_fa": "موسیقی",
"background": "http://wall.hezaro.com/static/assets/img/category-bg.jpg",
"count": 14,
"description": ""
}
]
}

دریافت پادکست‌های یک دسته‌بندی

get
Categories/id

http://wall.hezaro.com/api/v1/categories/{id}
Request
Response
Query Parameters
offset
optional
number
page
optional
number
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": [
{
"id": 130,
"title": "کامپایل",
"description": "پادکستی از طرف یه برنامه نویس برای برنامه نویس ها.\n\nدنیای برنامه نویسی یه دنیاییه که هر کد نویسی یه سفر متفاوتی توش تجربه میکنه ، پر از جذابیت ها و شکست ها. این پادکست راجع به سفر شخصی خودم هست، مواردی که ذهنم را مشغول کرده و دغدغه ی ذهنی من بوده. براتون از این دغدغه ها حرف میزنم",
"website": "https://anchor.fm/compile-podcast",
"creator": "پادکست کامپایل",
"episodes_count": 10,
"cover": "http://wall.hezaro.com/media/poster/podcast_130.jpg"
},
{
"id": 108,
"title": "راندوو",
"description": "راندوو پادکستیه که درون قراره یک رمان فرانسوی رو با هم بخونیم، ترجمه کنیم و اگه لازم شد توضیح بدیم و میتونه به درد کسایی بخوره که زبان فرانسه بلدند، دارند یاد می گیرند یا فقط به زبان فرانسه یا به صورت کلی تر به رمان علاقمندند",
"website": "https://randevoo.podbean.com/",
"creator": "مصطفی شالچی",
"episodes_count": 22,
"cover": "http://wall.hezaro.com/media/poster/podcast_108.jpg"
},
{
"id": 13,
"title": "پاراتک",
"description": "پادکستی درباره رویدادها و روندهای تکنولوژی",
"website": "https://theparatech.com/",
"creator": "امیرصادق پور و نیما دادگستر",
"episodes_count": 10,
"cover": "http://wall.hezaro.com/media/poster/podcast_13.jpg"
},
{
"id": 18,
"title": "رادیو بلاک چین",
"description": "رادیو بلاکچین پادکستی با هدف بیان مسائل فنی بلاکچین به زبان ساده است.",
"website": "http://radio-blockchain.com",
"creator": "یاشار راشدی",
"episodes_count": 23,
"cover": "http://wall.hezaro.com/media/poster/podcast_18.png"
},
{
"id": 199,
"title": "پادگپ",
"description": "پادگپ یه پادکست هفتگی در مورد پادکست‌های فارسیه.\n توی هر هفته، اگه پادکست تازه‌ای منتشر بشه، یا یه پادکست، قسمت جدیدی منتشر کنه بهتون اطلاع می‌دم، در موردش حرف می‌زنم و بخش‌های کوتاهی ازش رو براتون پخش می‌کنم. با پادکسترها و کسایی که نقشی در فضای پادکست فارسی دارن صحبت می‌کنم و شما رو در جریان رویدادهایی که در این حوزه اتفاق می‌افته می‌ذارم.\nپادگپ رو توی همه شبکه‌های اجتماعی با آیدی podgapcast می‌تونین دنبال کنین و اگه مطلبی رو می‌خواین با ما به اشتراک بذارین تا در موردش توی شماره بعدی صحبت کنیم از #پادگپ استفاده کنید.",
"website": "https://anchor.fm/podgap",
"creator": "میثم دهقانی",
"episodes_count": 6,
"cover": "http://wall.hezaro.com/media/poster/podcast_199.jpg"
},
{
"id": 17,
"title": "رادیو بادیو",
"description": "",
"website": "https://budio.ir/",
"creator": "گروه برسام",
"episodes_count": 16,
"cover": "http://wall.hezaro.com/media/poster/podcast_17.jpg"
},
{
"id": 15,
"title": "خورشت تکنولوژی",
"description": "",
"website": "https://itunes.apple.com/us/podcast/khoresht-e-tech-%D8%AE%D9%88%D8%B1%D8%B4%D8%AA-%D8%AA%DA%A9%D9%86%D9%88%D9%84%D9%88%DA%98%DB%8C/id1322206184?mt=2",
"creator": "",
"episodes_count": 70,
"cover": "http://wall.hezaro.com/media/poster/podcast_15.jpg"
},
{
"id": 38,
"title": "سبکتو",
"description": "\n در پادکست‌های سبکتو در کنار شنونده‌هامون به دنبال یافتن سبک زندگی موفق هستیم و تجربیاتمون رو به اشتراک می‌زاریم.\n پادکست‌های سبکتو معمولا حدود ۷ دقیقه هستند اما گاهی وقت‌ها به خاطر نوع مطلب یا مصاحبه بلندتر از این زمان منتشر می‌شوند.\n ",
"website": "https://sabketo.com",
"creator": "سبکتو",
"episodes_count": 274,
"cover": "http://wall.hezaro.com/media/poster/podcast_38.jpg"
},
{
"id": 218,
"title": "وبمستر پلاس",
"description": "پادکست های دیجیتالی",
"website": "webmasterplus.ir",
"creator": "webmasterplus",
"episodes_count": 43,
"cover": "http://wall.hezaro.com/media/poster/podcast_218.png"
},
{
"id": 150,
"title": "بینوشا کست",
"description": "بینوشا، ببین و بشنو همراه با تکنولوژی",
"website": "t.me/binoshacast",
"creator": "BinoshaCast",
"episodes_count": 3,
"cover": "http://wall.hezaro.com/media/poster/podcast_150.jpg"
},
{
"id": 20,
"title": "رادیوگیک",
"description": "در دفاع از آزادی کیبرد",
"website": "jadi.net",
"creator": "جادی",
"episodes_count": 21,
"cover": "http://wall.hezaro.com/media/poster/podcast_20.png"
},
{
"id": 100,
"title": "TEDxFa",
"description": "TED talks in Farsi",
"website": "https://itunes.apple.com/us/podcast/tedxfa/id1446095558?mt=2",
"creator": "فاطمه غفوریان",
"episodes_count": 9,
"cover": "http://wall.hezaro.com/media/poster/podcast_100.jpg"
},
{
"id": 82,
"title": "دو نقطه",
"description": "\r\nپادکستِ دونقطه :\r\n\"دو نقطه\" تلاشیه برای جستجوی جواب سوال‌ها؛ از زوایایی که کمتر ازش صحبت شده",
"website": "https://soundcloud.com/user-90844264/",
"creator": "دو نقطه",
"episodes_count": 1,
"cover": "http://wall.hezaro.com/media/poster/podcast_82.jpg"
},
{
"id": 133,
"title": "تد و کمی بیشتر",
"description": "تد و کمی بیشتر از تد",
"website": "https://tedandmore.podbean.com",
"creator": "آریا واحدی",
"episodes_count": 5,
"cover": "http://wall.hezaro.com/media/poster/podcast_133.png"
},
{
"id": 159,
"title": "شیر یا خط",
"description": "شیر یا خط٫ یک پادکست دوستانه در مورد بیت کوین٫ دیگر کوین های غیر متمرکز و تکنولوژی بلاکچین است.\n\nWe talk Bitcoin and Blockchain in Farsi.\n\n\nنظرات ارايه شده در این گفتگو ها نظرات شخصی بوده و جهت حمایت و علیه گروه خاصی نیست.\n\n\n.\n.\n.\n\nBitcoin, Farsi, Iran, Blockchain, فارسی , بلاک چین, بیت کوین٫بلاکچین, بیتکوین٫ ایران",
"website": "https://itunes.apple.com/us/podcast/shir-khat-persian-blockchain-podcast/id1221206951?mt=2",
"creator": "پادکست شیر یا خط",
"episodes_count": 13,
"cover": "http://wall.hezaro.com/media/poster/podcast_159.jpg"
}
]
}

لایک یک اپیزود

با استفاده از این پایانه میتوانید یک اپیزود را لایک کنید.

لایک کردن تنها برای کاربران مجاز است. قراردادن jwt در هدر را فراموش نکنید.

post
Like

http://wall.hezaro.com/api/v1/likes/{episode_id}
Request
Response
Path Parameters
episode_id
required
string
200: OK
{
"meta": {
"status": 201,
"message": ""
},
"response": [
{
"id": 2530,
"title": "سه‌ : مقیاس ناپذیر باش!",
"description": "<p>متن پادکست :</p>\n<p>sadraa.me/ds</p>\n<p>مقاله پاول گراهام:</p>\n<p>http://paulgraham.com/ds.html</p>\n<p>وبسایت do things that don't scale:</p>\n<p>https://www.dothingsthatdontscale.com/</p>\n<p><br></p>\n<p>رپ فری استایل موسس دیزاین پیکل:</p>\n<p>https://www.facebook.com/designpickle/videos/second-attempt-to-freestyle-raps-for-annual-upgrades/1637686729622912/</p>",
"creator": "",
"votes": 1,
"views": 1,
"cover": "http://localhost:8000/media/poster/2530.jpg",
"source": "https://anchor.fm/s/8d5e6e0/podcast/play/2962992/https%3A%2F%2Fd3ctxlq1ktw2nl.cloudfront.net%2Fproduction%2F2019-3-17%2F12956837-22050-2-10720e39f5b25.mp3",
"duration": "1892",
"mime_type": "audio/mpeg",
"published_at": 1555507140.0,
"comments_count": 0,
"podcast": {
"id": 2,
"title": "startbox",
"website": "http://startboxpodcast.com/",
"creator": "صدرا علی‌ابادی",
"episodes_count": 3
}
}
]
}

آن لایک کردن یک اپیزود

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

delete
Like

http://wall.hezaro.com/api/v1/likes/{episode_id}
Request
Response
Path Parameters
episode_id
required
string
200: OK

ذخیره‌ی جایی که کاربر تا آنجا گوش داده است

کاربر ممکن است گوش دادن فایل را نیمه کاره رها کند و بعدا بخواهد ادامه آن را گوش کند. برای هر کاربر و فایل میتوانید ثانیه‌ای که کاربر آن را رها کرده است را با استفاده از پایانه زیر ذخیره کنید.

در اطلاعات هر اپیزود State آن اپیزود به شما بر خواهد گشت.

post
State

http://wall.hezaro.com/api/v1/episodes/{episode_id}/state
Request
Response
Path Parameters
episode_id
optional
string
Query Parameters
state
optional
number
Send the Seconds of file you want to save for the user
200: OK
{
"meta": {
"status": 200,
"message": "ثبت شد"
}
}

دریافت لیست بوکمارک‌های یک کاربر

از این آدرس میتوانید برای دریافت لیست بوک مارکهای یک کاربر استفاده کنید.

get
Bookmarks

http://wall.hezaro.com/api/v1/bookmarks
Request
Response
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": [
{
"id": 240,
"title": "بیست و دو: از کیم جونگ اون عکس نگیر",
"description": "<p>کیم جونگ اون، رهبر کره شمالی عکاس شخصی خود را اخراج کرد. این عکاس متهم شد که هنگام برگزاری انتخابات در کره شمالی تصویری نامناسب که در شان رهبر کره شمالی نبوده، گرفته و عظمت رهبری وی را زیر سوال برده است. در این پادکست از زندگی و سرنوشت این عکاس می‌گوییم.</p>\n<p>مقاله <a rel=\"nofollow\" href=\"https://www.digimage.ir/kim/\">بیست و دو: از کیم جونگ اون عکس نگیر</a> در وب‌سایت <a rel=\"nofollow\" href=\"https://www.digimage.ir\">دیج ایمیج - digimage</a> منتشر شد.</p>\n",
"creator": "",
"likes_count": 1,
"views_count": "۱",
"is_liked": true,
"is_bookmarked": false,
"cover": "http://example.com/static/assets/img/mic.png",
"source": "https://digimage.ir/podcast/22_Kim.mp3",
"length": 39008137,
"duration": "",
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1557206783.0,
"comments_count": "۰",
"podcast": {
"id": 4,
"title": "دیج ایمیچ",
"website": "",
"creator": "",
"episodes_count": 20,
"cover": "https://www.digimage.ir/wp-content/uploads/2018/01/cropped-Digimage-Favicon-0۱-32x32.png"
}
}
]
}

بوکمارک کردن یک اپیزود

با این پایانه میتوانید یک اپیزود را برای یک کاربر خاص بوکمارک کنید.

این که یک اپیزود برای یک کاربر بوک مارک شده است یا نه را در اطلاعات هر اپیزود میتوانید ببینید.

post
bookmarks/id

http://wall.hezaro.com/api/v1/bookmarks/{episode_id}
Request
Response
Path Parameters
episode_id
required
string
200: OK
{
"meta": {
"status": 201,
"message": ""
},
"response": [
{
"id": 240,
"title": "بیست و دو: از کیم جونگ اون عکس نگیر",
"description": "<p>کیم جونگ اون، رهبر کره شمالی عکاس شخصی خود را اخراج کرد. این عکاس متهم شد که هنگام برگزاری انتخابات در کره شمالی تصویری نامناسب که در شان رهبر کره شمالی نبوده، گرفته و عظمت رهبری وی را زیر سوال برده است. در این پادکست از زندگی و سرنوشت این عکاس می‌گوییم.</p>\n<p>مقاله <a rel=\"nofollow\" href=\"https://www.digimage.ir/kim/\">بیست و دو: از کیم جونگ اون عکس نگیر</a> در وب‌سایت <a rel=\"nofollow\" href=\"https://www.digimage.ir\">دیج ایمیج - digimage</a> منتشر شد.</p>\n",
"creator": "",
"likes_count": 1,
"views_count": "۱",
"is_liked": true,
"is_bookmarked": false,
"cover": "http://example.com/static/assets/img/mic.png",
"source": "https://digimage.ir/podcast/22_Kim.mp3",
"length": 39008137,
"duration": "",
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1557206783.0,
"comments_count": "۰",
"podcast": {
"id": 4,
"title": "دیج ایمیچ",
"website": "",
"creator": "",
"episodes_count": 20,
"cover": "https://www.digimage.ir/wp-content/uploads/2018/01/cropped-Digimage-Favicon-0۱-32x32.png"
}
}
]
}

پاک کردن بوک مارک

با این پایانه میتوانید بوک مارک یک اپیزود را برای یک کاربر پاک کنید.

delete
bookmarks/id

http://wall.hezaro.com/api/v1/bookmarks/{episode_id}
Request
Response
Path Parameters
episode_id
required
string
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": [
{
"id": 240,
"title": "بیست و دو: از کیم جونگ اون عکس نگیر",
"description": "<p>کیم جونگ اون، رهبر کره شمالی عکاس شخصی خود را اخراج کرد. این عکاس متهم شد که هنگام برگزاری انتخابات در کره شمالی تصویری نامناسب که در شان رهبر کره شمالی نبوده، گرفته و عظمت رهبری وی را زیر سوال برده است. در این پادکست از زندگی و سرنوشت این عکاس می‌گوییم.</p>\n<p>مقاله <a rel=\"nofollow\" href=\"https://www.digimage.ir/kim/\">بیست و دو: از کیم جونگ اون عکس نگیر</a> در وب‌سایت <a rel=\"nofollow\" href=\"https://www.digimage.ir\">دیج ایمیج - digimage</a> منتشر شد.</p>\n",
"creator": "",
"likes_count": 1,
"views_count": "۱",
"is_liked": true,
"is_bookmarked": false,
"cover": "http://example.com/static/assets/img/mic.png",
"source": "https://digimage.ir/podcast/22_Kim.mp3",
"length": 39008137,
"duration": "",
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1557206783.0,
"comments_count": "۰",
"podcast": {
"id": 4,
"title": "دیج ایمیچ",
"website": "",
"creator": "",
"episodes_count": 20,
"cover": "https://www.digimage.ir/wp-content/uploads/2018/01/cropped-Digimage-Favicon-0۱-32x32.png"
}
}
]
}

سرچ و چیزهای وابسته

کلید واژه های سرچ شده مکان های زیر را جستجو میکنند:

عنوان پادکست

توضحات پادکست

نام پادکستر ها

همچنین با استفاده از پارامترهای min و max میتوانید پادکستهایی با مدت زمان دلخواه خود استفاده کنید. این قابلیت میتواند برای پیدا کردن پادکستی با مدت زمان نزدیک به ETA در نقشه‌ها و مسیریاب‌ها استفاده شود.

برای استفاده از min و max باید از واحد دقیقه استفاده کنید.

http://wall.hezaro.com/api/v1/search
Request
Response
Query Parameters
max
optional
number
Maximum duration(minutes)
min
optional
number
Minimum duration(minutes)
page
optional
number
offset
optional
number
q
optional
string
The query you want to search
200: OK
{
"meta": {
"status": 200,
"message": ""
},
"response": [
{
"id": 165,
"title": "سه‌ : مقیاس ناپذیر باش!",
"description": "<p>متن پادکست :</p>\n<p>sadraa.me/ds</p>\n<p>مقاله پاول گراهام:</p>\n<p>http://paulgraham.com/ds.html</p>\n<p>وبسایت do things that don't scale:</p>\n<p>https://www.dothingsthatdontscale.com/</p>\n<p><br></p>\n<p>رپ فری استایل موسس دیزاین پیکل:</p>\n<p>https://www.facebook.com/designpickle/videos/second-attempt-to-freestyle-raps-for-annual-upgrades/1637686729622912/</p>",
"creator": "",
"votes": 0,
"views": 1,
"is_liked": false,
"cover": "http://example.com/media/poster/165.jpg",
"source": "https://anchor.fm/s/8d5e6e0/podcast/play/2962992/https%3A%2F%2Fd3ctxlq1ktw2nl.cloudfront.net%2Fproduction%2F2019-3-17%2F12956837-22050-2-10720e39f5b25.mp3",
"length": 31661625,
"duration": 1892,
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1555507140.0,
"comments_count": 0,
"podcast": {
"id": 1,
"title": "startbox",
"website": "http://startboxpodcast.com",
"creator": "صدرا علی‌آبادی",
"episodes_count": 3,
"cover": "https://s3-us-west-2.amazonaws.com/anchor-generated-image-bank/production/podcast_uploaded/1382360/1382360-1548659312029-eaba173a64cc4.jpg"
}
},
{
"id": 166,
"title": " (Zero to one) دو: خلاصه کتاب صفر تا یک ",
"description": "<p>وبسایت پادکست:</p>\n<p><a href=\"Https://startboxpodcast.com\">Https://startboxpodcast.com</a></p>\n<p><br></p>\n<p>وبسایت شتابدهنده هاب:</p>\n<p><a href=\"mcihubacc.com\">mcihubacc.com</a></p>\n<p><br></p>\n<p>نسخه آزاد و فارسی کتاب صفر تا یک:</p>\n<p><a href=\"0to1.ir\">0to1.ir</a></p>\n<p><br></p>\n<p><br></p>",
"creator": "",
"votes": 0,
"views": 1,
"is_liked": false,
"cover": "http://example.com/media/poster/166.jpg",
"source": "https://anchor.fm/s/8d5e6e0/podcast/play/2499775/https%3A%2F%2Fd3ctxlq1ktw2nl.cloudfront.net%2Fproduction%2F2019-1-27%2F10554621-44100-2-cb609904e22a.mp3",
"length": 58509011,
"duration": 1819,
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1551267315.0,
"comments_count": 0,
"podcast": {
"id": 1,
"title": "startbox",
"website": "http://startboxpodcast.com",
"creator": "صدرا علی‌آبادی",
"episodes_count": 3,
"cover": "https://s3-us-west-2.amazonaws.com/anchor-generated-image-bank/production/podcast_uploaded/1382360/1382360-1548659312029-eaba173a64cc4.jpg"
}
},
{
"id": 167,
"title": "(Lean StartUp)یک : خلاصه کتاب لین استارت آپ ",
"description": "<p>توی این قسمت در مورد کتاب لین استارت اپ صحبت میکنیم.</p>\n<p><br></p>\n<p>لینک وبسایت پادکست:</p>\n<p>startboxpodcast.com</p>\n<p>شتابدهنده هاب:</p>\n<p>mcihubacc.com</p>\n<p>وبلاگ میزبان:</p>\n<p>sadraa.me</p>\n<p><br></p>\n<p>سخنرانی آقای ریس در گوگل :</p>\n<p>https://www.youtube.com/watch?v=fEvKo90qBns</p>\n<p><br></p>\n<p>کتاب تست مامان:</p>\n<p>https://www.pingon.io/books/mom-test/fa</p>",
"creator": "",
"votes": 0,
"views": 1,
"is_liked": false,
"cover": "http://example.com/media/poster/167.jpg",
"source": "https://anchor.fm/s/8d5e6e0/podcast/play/2205184/https%3A%2F%2Fd3ctxlq1ktw2nl.cloudfront.net%2Fproduction%2F2019-0-27%2F8921876-48000-2-d0e8a7792130e.mp3",
"length": 26052034,
"duration": 1569,
"state": 0,
"mime_type": "audio/mpeg",
"published_at": 1548587581.0,
"comments_count": 0,
"podcast": {
"id": 1,
"title": "startbox",
"website": "http://startboxpodcast.com",
"creator": "صدرا علی‌آبادی",
"episodes_count": 3,
"cover": "https://s3-us-west-2.amazonaws.com/anchor-generated-image-bank/production/podcast_uploaded/1382360/1382360-1548659312029-eaba173a64cc4.jpg"
}
}
]
}