آگهی (Post)
مقدمه
در اکوسیستم دیوار، موجودیت (Entity) محوری و اصلی، آگهی یا Post میباشد. در پلتفرم کنار دیوار نیز این مفهوم بنیادین با همان ساختار و اهمیت وجود دارد. این مستند به منظور آشنایی عمیق توسعهدهندگان با جزئیات و ویژگیهای خاص آگهی در پلتفرم کنار تهیه شده است.
توکن (شناسه) آگهی
در دیوار، هر آگهی فعال یک شناسهی متنی منحصر به فرد دارد که به آن توکن آگهی (Post Token) گفته میشود. این توکن کلید اصلی برای دسترسی و ارجاع به یک آگهی خاص است.
نحوه مشاهده و ساختار توکن آگهی: برای درک بهتر مفهوم توکن، میتوانید به وبسایت دیوار (divar.ir) مراجعه کنید. پس از جستجو و کلیک بر روی یک آگهی، به آدرس URL آن در مرورگر خود توجه کنید. این URL ساختاری مشابه زیر دارد:
فرمت لینکهای آگهی به صورت https://divar.ir/v/{بخش-مربوط-به-سئو-و-خوانایی-URL}/{توکن-آگهی}
میباشد.
به عنوان مثال: https://divar.ir/v/فروش-فوری-آپارتمان-اکازیون/gW4fL8Xq
در این مثال:
gW4fL8Xq
همان توکن آگهی است.فروش-فوری-آپارتمان-اکازیون
بخشی است که برای بهبود خوانایی URL و بهینهسازی برای موتورهای جستجو (SEO) استفاده میشود و در شناسایی یکتای آگهی نقشی ندارد.
مشخصات فنی توکن آگهی:
- طول: معمولاً ۸ یا ۹ کاراکتر.
- کاراکترهای مجاز: ترکیبی از حروف بزرگ و کوچک انگلیسی و اعداد (
[_a-zA-Z0-9]
).- ملاحظات ذخیرهسازی برای توسعهدهندگان: با توجه به اینکه طول این توکن ممکن است در آینده تا حداکثر ۱۶ کاراکتر افزایش یابد، هنگام طراحی پایگاه داده و تعریف فیلد مربوط به توکن آگهی، حتماً این افزایش احتمالی را در نظر بگیرید (مثلاً VARCHAR(20) یا بیشتر).
توکن مدیریت (Management Token)
توکن آگهی یک شکل دیگر نیز دارد که به آن توکن مدیریت گفته میشود. این توکن معمولاً از توکن عمومی آگهی طولانیتر است، اما پیشوند (prefix) آن با توکن عمومی آگهی یکسان میباشد.
مثال:
اگر توکن عمومی آگهی post1234
باشد، توکن مدیریت آن میتواند مقداری شبیه به post1234mngABCXYZ
داشته باشد (که mngABCXYZ
پسوند مدیریتی است).
نکته مهم برای توسعهدهندگان پلتفرم کنار: هدف از توضیح این بخش صرفاً ارائه اطلاعات تکمیلی برای درک عمیقتر سازوکار داخلی دیوار است. پلتفرم کنار به هیچ وجه و تحت هیچ شرایطی توکن مدیریت (توکن خصوصی) را در اختیار شما قرار نمیدهد. قابلیتهایی نظیر ویرایش آگهی، نردبان کردن، یا سایر عملیات مدیریتی که ممکن است در دیوار مستلزم استفاده از توکن مدیریت باشند، در پلتفرم کنار از طریق توکن عمومی آگهی و با استفاده از APIهای مشخص و امنی که پلتفرم کنار برای این منظور ارائه میدهد، در دسترس شما خواهند بود. پلتفرم کنار مسئولیت مدیریت تعاملات لازم با سیستمهای داخلی دیوار را بر عهده دارد.