پرش به مطلب اصلی

برنامه تستی (Development App)

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

هدف اصلی این برنامه‌ها، فراهم کردن یک چرخه‌ی توسعه سریع و بدون محدودیت‌های تایید است تا بتوانید تمام قابلیت‌های مورد نظر خود را به راحتی پیاده‌سازی کنید.

ویژگی‌های کلیدی

  • توسعه سریع و بدون تایید: هرگونه تغییر در مشخصات برنامه‌های تستی (مانند نام، توضیحات یا Redirect URI) نیازی به تایید تیم کنار ندارد و بلافاصله اعمال می‌شود.
  • محیط ایزوله: برنامه‌های تستی برای کاربران عادی دیوار قابل مشاهده نیستند و فقط برای شما و تیم توسعه‌تان در دسترس قرار دارند.
  • هشدار در جریان OAuth: هنگام اتصال کاربر به یک برنامه تستی، هشداری مبنی بر "تستی بودن برنامه" به او نمایش داده می‌شود. این هشدار در برنامه‌های نسخه نهایی (Production) وجود نخواهد داشت.
  • دسترسی کامل به Scope ها: برنامه‌های تستی به تمام دسترسی‌های (Scopes) ممکن در OAuth دسترسی دارند تا بتوانید تمام قابلیت‌ها را بدون محدودیت آزمایش کنید.

دسترسی‌ها و محدودیت‌ها (Permissions & Rate Limits)

محدودیت‌های API در برنامه‌های تستی به گونه‌ای طراحی شده‌اند که ضمن فراهم کردن یک محیط کامل برای توسعه، از فعالیت‌های مخرب مانند Crawl کردن اطلاعات و استفاده‌های خلاف قوانین پلتفرم جلوگیری کنند.

برای مشاهده لیست کامل دسترسی‌ها و محدودیت‌های Rate Limit برنامه خود:

  1. به صفحه مدیریت برنامه‌ها بروید.
  2. برنامه تستی مورد نظر را پیدا کرده و روی دکمه «دسترسی‌ها» کلیک کنید.
  3. یا مستقیماً از لینک زیر استفاده کنید و {your_app_slug} را با شناسه برنامه خود جایگزین کنید:
    https://divar.ir/kenar/management/apps/{your_app_slug}/permission
پیش از ثبت تیکت

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

اگر در حین توسعه با محدودیت Rate Limit مواجه شدید یا به دسترسی خاصی برای یک سناریوی مجاز نیاز داشتید، می‌توانید یک تیکت برای تیم پشتیبانی ثبت کنید:

ثبت تیکت جدید

نحوه استفاده و محدودیت‌های عملی

برای تست عملکرد برنامه خود، باید از «آگهی تستی» استفاده کنید. این آگهی‌ها به صورت ویژه برای تعامل با برنامه‌های تستی ساخته شده‌اند.

برای آشنایی کامل با نحوه ساخت و استفاده از آگهی‌های تستی، مستندات زیر را مطالعه کنید:


مستندات آگهی تستی

در حال حاضر، برنامه‌های تستی می‌توانند در نقاط تماس (Touch Points) مربوط به یک آگهی تستی نمایش داده شوند.

عدم نمایش در پنل‌ها

توجه داشته باشید که در حال حاضر، برنامه‌های تستی در لیست «افزونه‌های دیوار من» یا «پنل حرفه‌ای» کاربران نمایش داده نمی‌شوند. این قابلیت تنها برای برنامه‌های نسخه نهایی (Production) فعال است.

قانون طلایی: فقط آگهی تستی!

برنامه‌های تستی فقط و فقط مجاز به فعالیت روی «آگهی‌های تستی» هستند. هرگونه تلاش برای تعامل با آگهی‌های واقعی (غیر تستی) منجر به خطا خواهد شد. برای مثال:

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