کنار دیوار بستری برای افزودن اطلاعات و خدمات به دیوار است. با ارائهٔ خدمات خود در کنار دیوار، به کاربران دیوار کمک کنید تجربهٔ خرید و فروش ساده‌تر، مطمئن‌تر و دلنشین‌تری را تجربه کنند. در کنار دیوار می‌توانید:
- به آگهی‌گذاران کمک کنید اطلاعات تکمیلی در آگهی‌های خود درج کنند.
- با همکاری آگهی‌گذاران خدمات تکمیلی روی آگهی‌ها ارائه دهید.
- با ارائهٔ خدمات در چت، تعامل کاربران را در راستای معاملهٔ سریع‌تر و مطمئن‌تر تسهیل کنید.
🚀 برای شروع کار در کنار دیوار، در لیست انتظار ثبت‌نام کنید تا دسترسی شما به پنل کنار دیوار را فراهم کنیم.
🚧 در دست احداث 🚧
کنار دیوار در حال حاضر در مرحلهٔ آزمایشی است و امکان ثبت‌نام عمومی وجود ندارد. برای ثبت‌نام و ارائهٔ خدمات در این بستر، در لیست انتظار ثبت‌نام کنید. در این مرحله ممکن است قواعد، سیاست‌ها و ابزارهای کنار دیوار دچار تغییرات ناگهانی شوند. به دلیل سرعت تغییرات، ممکن است در بازه‌های زمانی خاصی اطلاعات ارائه شده در این مخزن نیز ناقص یا نیازمند بروزرسانی باشند.
برای ارسال اولین درخواست به API های کنار دیوار این مراحل را بروید.
۱. در پنل کنار دیوار وارد شوید.
۲. یک برنامهٔ تستی بسازید، یا از مدیر یک برنامهٔ دیگر بخواهید شما را به برنامه‌اش اضافه کند.
۳. برای برنامهٔ مورد نظرتان کلید API بسازید.
۴. در قسمت آگهی‌های تستی یک آگهی بسازید تا بتوانید راحت‌تر تست کنید.
۵. این فهرست درخواست‌ها را دانلود کنید و در ابزارهایی مثل Postman وارد کنید و شروع کنید.
خدمات مختلف در کنار دیوار در قالب «برنامه» یا «اپلیکیشن» (Application) ها به کاربران ارائه می‌شوند. کاربران در نقاط مشخصی از دیوار مثل صفحهٔ آگهی یا چت، می‌توانند به درخواست خودشان با برنامهٔ شما در قالب یک برنامهٔ وب (Web Application)تعامل کنند، در صورت نیاز اجازه‌های لازم را به شما بدهند، خدمات مورد نظر را دریافت کنند و به دیوار برگردند.
برنامه‌های متصل به کنار دیوار با هر زبانی می‌توانند توسعه یابند، اما برقراری ارتباطشان با کنار دیوار از طریق درخواست‌های HTTP خواهد‌بود.
در مرحلهٔ آزمایشی، برای تعریف برنامهٔ جدید با ما تماس بگیرید.
جزییات برنامه(ها)ی خود را در صفحهٔ اپ‌ها در پنل کنار دیوار می‌توانید ببینید. اطلاعات بیشتر در مورد مدیریت برنامه‌ها را اینجا بخوانید.
در حال حاضر خدماتی که از طریق صفحات مربوط به آگهی می‌توانید ارائه دهید، در قالب زیر است:
۱. برنامه‌های مرتبط با آگهی (از نظر دسته، شهر یا موارد دیگر) در قسمت مدیریت آگهی به کاربر پیشنهاد می‌شود.
۲. کاربر پس از انتخاب برنامهٔ شما، به آدرس مشخص شده هدایت می‌شود و وب‌اپلیکیشن شما در اپ دیوار باز خواهد شد.
۳. در صورت نیاز می‌توانید در وب‌اپ خود اطلاعات آگهی، اطلاعات کاربر یا آگهی‌های کاربر (با کسب اجازهٔ کاربر) را از دیوار دریافت کنید.
۵. به علاوه می‌توانید از کاربر اجازهٔ درج محتوا در آگهی مورد نظر را نیز بگیرید. این محتوا از ویجت‌های دیوار مثل متن، عکس، امتیاز و ... تشکیل می‌شود.
۵. پس از پایان کار، برنامه باید کاربر را به دیوار برگرداند.
۶. پس از انتشار، کاربران آگهی‌بیننده می‌توانند با محتوای درج‌شده تعامل داشته‌باشند (برای مثال، با استفاده از دکمه‌های اضافه شده، آدرس‌های مشخص شده در برنامهٔ شما را باز کرده و با وب‌اپلیکیشن شما تعامل کنند). دقت کنید که حتما بعد از پایان تعامل با کاربر، وی را به دیوار بازگردانید.
💡 مثال
یک سرویس کارشناسی خودرو بعد از ثبت یک آگهی خودرو سواری به کاربر معرفی می‌شود، کاربر به آدرس مشخص شده توسط برنامه هدایت می‌شود، برنامه شمارهٔ تماس کاربر و اطلاعات آگهی و اجازهٔ درج مکمل در آگهی را از کاربر دریافت می‌کند و با هماهنگی کاربر خودرو را کارشناسی می‌کند. سپس خلاصه‌ای از گزارش کارشناسی را به آگهی اضافه کرده و دکمه‌ای نیز برای مشاهدهٔ جزییات گزارش به انتهای خلاصه می‌افزاید.
💡 مثال
یک سرویس پرداخت آنلاین، بعد از ثبت آگهی کالای نو، با فروشنده هماهنگ کرده، اطلاعات و مجوزهای لازم را از وی می‌گیرد، سپس با افزودن دکمهٔ پرداخت آنلاین به آگهی، به آگهی‌‌بینندگان امکان پرداخت سریع و از طریق درگاه را فراهم می‌آورد.
📖 اطلاعات بیشتر در مورد افزونه‌های آگهی‌ها را اینجا بخوانید.
ارائهٔ خدمات در چت دیوار به طور کلی در قالب زیر انجام می‌شود:
۱. برنامه‌های مرتبط با آگهی و چتٔ کاربران به آنها پیشنهاد داده‌می‌شود.
۲. پس از انتخاب برنامهٔ شما توسط کاربر، درخواستی از طرف دیوار به آدرسی که از قبل توسط شما در پنل مشخص شده ارسال می‌شود و کاربر به آدرسی که در پاسخ به درخواست دیوار می‌دهید، هدایت می‌شود.
۳. در این مرحله شما می‌توانید اطلاعات آگهی یا اطلاعات کاربر را (با اجازهٔ کاربر) از دیوار بگیرید.
۴. به علاوه، در این مرحله می‌توانید با اجازهٔ کاربر، در چت پیام ارسال کنید.
۵. شما می‌توانید به پیام‌های ارسالی در چت، دکمه‌هایی برای طرفین چت ضمیمه کنید که کاربران با استفاده از آنها، با برنامهٔ شما تعامل نمایند.
۶. بعد از پایان تعامل، برنامهٔ شما باید کاربر را به دیوار برگرداند.
💡 مثال
برنامهٔ پرداخت به کاربر خریدار پیشنهاد شده و وی برنامه را باز کرده، به آدرس ارسالی هدایت می‌شود. برنامه اطلاعات آگهی و شمارهٔ کاربر را دریافت کرده و از طریق درگاه بانکی، مبلغ را از وی دریافت می‌کند. برنامهٔ پرداخت سپس پیامی در چت ارسال می‌کند که ذیل آن دکمه‌ای برای فروشنده قرار گرفته تا از طریق آن، مبلغ را دریافت کند. فروشنده با زذ دکمه به آدرس مشخص شده هدایت می‌شود، برنامه شمارهٔ تماس وی را از دیوار دریافت کرده و سپس با دریافت اطلاعات بانکی، مبلغ را به فروشنده منتقل می‌کند.
💡 مثال
برنامهٔ تنظیم قرارداد به کاربر پیشنهاد می‌شود. وی از طریق برنامه نمونهٔ قرارداد دلخواه را انتخاب کرده، اطلاعات مربوط به خویش را وارد کرده و به شکل دیجیتال امضاء می‌کند. برنامه لینک مربوط به این قرارداد را به همراه پیامی در چت برای طرف دیگر ارسال می‌کند، کاربر دیگر با باز کردن لینک مشخص شده قرارداد را پر نموده و به صورت دیجیتال امضاء می‌کند، سپس برنامه نسخهٔ امضاء شده را برای طرفین در چت ارسال می‌کند.
📖 اطلاعات بیشتر در مورد افزونه‌های چت را اینجا بخوانید.
برای استفاده از قابلیت‌های کنار دیوار باید درخواست‌های HTTP به آدرس مربوطه ارسال کنید. هر درخواست باید شامل یک کلید API متعلق به برنامهٔ شما باشد تا دیوار از طریق آن هویت شما را احراز کند. برای ایجاد کلید برای برنامهٔ خود به صفحهٔ کلیدها در پنل کنار مراجعه کنید.
🔒 نکات امنیتی
🔑 کلید را در هدرx-api-keyقرار دهید. درخواست‌های بدون کلید رد خواهند شد.
🙈 در پنل کنار، کلید API را فقط در زمان ساخت می‌توانید ببینید. در نگهداری از آن دقت کنید.
🤹 یک اپلیکیشن می‌تواند کلیدهای مختلف با دسترسی‌های متفاوت داشته باشد.
🛂 مطمئن شوید که هر کلید کمینهٔ دسترسی‌های مورد نیاز را دارد.
🕰️ کلیدها را به شکل دوره‌ای و منظم پاک کرده و با کلیدهای جدید جایگزین کنید.
🔥 هر اپلیکیشن می‌تواند فقط یک کلید برای دریافت اجازه‌های مختلف از کاربر داشته باشد.
📖 برای اطلاعات بیشتر در مورد امنیت کلیدها اینجا را بخوانید. برای اطلاعات بیشتر در مورد کلیدهای API اینجا را بخوانید.
برخی قابلیت‌ها، مثل دریافت اطلاعات شخصی کاربران یا افزودن محتوا به آگهی، نیازمند دریافت اجازه از کاربر هستند. در کنار دیوار، این فرآیند بر مبنای استاندارد OAuth 2.0 انجام می‌شود. برای کار با این استاندارد، در زبان‌ها و فریم‌ورک‌های مختلف، ابزارهای متنوعی وجود دارند که برخی از آنها را می‌توانید اینجا ببینید. برای اطلاعات بیشتر در این مورد، اینجا را بخوانید.
- برای تست خدمات روی آگهی‌ها اینجا را بخوانید.
- برای تست خدمات در چت اینجا را بخوانید.
