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

قیمت‌گذاری آگهی

با استفاده از این API و با مجوز کاربر، می‌توانید قیمت خدمات مختلف مانند نردبان را دریافت کنید. قیمت این API لزوماً همان قیمتی که در دیوار نمایش داده می‌شود نیست و ممکن است قیمت‌گذاری متفاوت باشد. از این API برای دریافت قیمت قبل از اعمال خدمات (مانند نردبان آگهی) استفاده کنید.

دسترسی‌های مورد نیاز​

برای استفاده از این API نیاز به دسترسی‌های زیر دارید:

  • دسترسی OAuth: PAYMENT_ALL_POSTS_PRICING_READ
  • دسترسی API Key: POST_PRICING_RETRIEVE

دریافت قیمت‌گذاری آگهی​

GET https://open-api.divar.ir/v1/open-platform/post/{{post_token}}/pricing
x-api-key: {{apikey}}
Authorization: Bearer {{access_token}}

پارامترهای درخواست​

پارامترنوعاجباریتوضیحات
post_tokenstringبلهشناسه منحصر به فرد آگهی که ۸ تا ۹ کاراکتر است

پاسخ​

{
    "reorder": {
        "cost_rials": 50000,
        "available": true
    }
}

پارامترهای پاسخ​

شیء Reorder​

پارامترنوعتوضیحات
cost_rialsint64هزینه نردبان به ریال
availableboolنشان می‌دهد که آیا آگهی قابل نردبان است یا خیر. اگر false باشد، API نردبان خطا برمی‌گرداند

نکات مهم​

  • قیمت‌ها در ریال محاسبه می‌شوند
  • قبل از هر درخواست نردبان، باید از این API برای بررسی قیمت و امکان‌پذیری استفاده کنید
  • در صورتی که available برابر false باشد یا این کلید reorder وجود نداشته باشد، نمی‌توانید آگهی را نردبان کنید
  • قیمت‌ها ممکن است به مرور زمان تغییر کنند