استها مقادیر اینامهای پرکاربرد دیوار هستند که برای تولید افزونه یا خواندن منابعی که از دیوار دریافت میکنید کاربرد دارند. برای مثال در جستجوی آگهی برای فیلتر کردن روی مقادیر برند-مدل خودرو از است برند-مدل میتوانید گزینههای موجود را دریافت کنید.
اگرچه این مقادیر ثابت هستند و به ندرت تغییر میکنند، اما تضمینی برای ثابت ماندن پاسخ دریافتی نیست و ممکن است هر زمان و بدون اطلاع تغییر کنند. البته ساختمان دادهٔ پاسخ، تغییری که باعث بروز خطا شود، نخواهد داشت.
درخواست
GET https://api.divar.ir/v1/open-platform/assets/category
نمونهٔ پاسخ
{
"categories": [
{
"display": "دسته بندی اصلی",
"slug": "root"
},
{
"display": "دسته بندی اصلی - املاک",
"slug": "real-estate"
},
// ...
]
}
درخواست
GET https://api.divar.ir/v1/open-platform/assets/city
نمونهٔ پاسخ
{
"cities": [
{
"display": "آبادان",
"slug": "abadan"
},
{
"display": "آباده",
"slug": "abadeh"
},
/// ...
]
}
ممکن است در سایر قسمتهای دیوار مقادیر عددی یا city_id مشاهده کنید. این مقادیر در کنار دیوار کاربردی ندارند و نباید استفاده شوند.
درخواست
GET https://api.divar.ir/v1/open-platform/assets/district
نمونهٔ پاسخ
{
"districts": [
{
"display": "آبشار",
"slug": "abshar"
},
// ...
]
}
میتوانید محلههای شهرهای زیر را از آدرسی که در ادامه میبینید دریافت کنید:
- tehran
- karaj
- mashhad
- isfahan
- shiraz
- rasht
- qom
- ahvaz
GET https://api.divar.ir/v1/open-platform/assets/district/{{city}}
سایر شهرهای دیوار دارای محله نیستند.
در دستههای light
برای خودرو و mobile-phones
برای کالاهای دیجیتال میتوانید از آدرس زیر لیست برندمدلها را دریافت کنید:
GET https://api.divar.ir/v1/open-platform/assets/brand-model/{{category}}
نمونهٔ پاسخ
{
"brand_models": [
{
"display": "همهی برندها",
"slug": "ROOT"
},
{
"display": "آئودی",
"slug": "Audi"
},
/// ...
]
}
مشابه برند-مدل، برای دستهبندیهای light
و mobile-phones
میتوانید لیست رنگهای موجود در دیوار را از آدرس زیر دریافت کنید.
GET https://api.divar.ir/v1/open-platform/assets/color/{{category}}
نمونه پاسخ
{
"colors": [
{
"display": "آبی",
"slug": "آبی"
},
{
"display": "آلبالویی",
"slug": "آلبالویی"
},
/// ...
]
}
GET https://api.divar.ir//v1/open-platform/assets/internal-storage
نمونهٔ پاسخ
{
"internal_storages": [
{
"display": "مطرح نیست",
"slug": "irrelevant"
},
{
"display": "۵۱۲ مگابایت",
"slug": "512MB"
},
/// ...
]
}
GET https://api.divar.ir//v1/open-platform/assets/ram-memory
نمونهٔ پاسخ
{
"ram_memories": [
{
"display": "مطرح نیست",
"slug": "irrelevant"
},
{
"display": "۵۱۲ مگابایت",
"slug": "512MB"
},
/// ...
]
}
GET https://api.divar.ir//v1/open-platform/assets/body-status
نمونهٔ پاسخ
{
"body_status": [
{
"display": "سالم و بیخط و خش",
"slug": "intact"
},
{
"display": "خط و خش جزیی",
"slug": "some-scratches"
},
/// ...
]
}