درج تصویر در ویجت‌ها
تعدادی از ویجت‌های دیوار امکان نمایش تصویر در قسمتی از خود را دارند. برای اضافه کردن تصویر به ویجت مورد نظر ابتدا باید تصویر را آپلود کنید و سپس شناسهٔ آن را در مشخصات ویجت قرار دهید.
آپلود تصویر
در ابتدا با یک رکوئست PUT باینری فایل تصویر خود را به صورت زیر آپلود کنید. (ترجیحا فرمت عکس ها jpeg باشد)
PUT /v2/image-service/open-platform/image.jpg HTTP/1.1
Host: divar.ir
Content-Type: image/jpeg
Content-Length: 22
"<file contents here>"
دفت شود کهimage.jpg انتهای url یک نام ثابت است و ربطی به نام عکس آپلودشده ندارد! (در تمام رکوئست ها image.jpg بگذارید)
پس از ارسال درخواست، چنین پاسخی دریافت می‌شود.
{
image_name: "57c76b48-d381-4b8a-b34f-355f6869b6ed.jpg",
}
درج تصویر در افزونه
حال در محل مورد نظرتان برای درج تصویر، id دریافتی از درخواست قبلی را قرار دهید.
برای مثال در نمونه درخواست زیر در ویجت EVENT_ROW تصویر مورد نظرمان را قرار دادیم.
POST /v2/open-platform/add-ons/post/AZqfx5i2 HTTP/1.1
Host: api.divar.ir
Content-Type: application/json
x-api-key: {{your-api-key}}
{
"widgets": [
{
"title_row": {
"text": "تایتل رو",
"has_divider": true
}
},
{
"event_row": {
"title": "یک اونت رو",
"subtitle": "اطلاعات بیشتر اونت رو",
"has_divider": true,
"image_url": "57c76b48-d381-4b8a-b34f-355f6869b6ed.jpg"
}
}
]
}
علاوه بر درج تصویر دلخواه می‌توان به جای {id} مقدار logo را به عنوان image_url فرستاد تا لوگوی اپ شما که در پنل کنار دیوار قابل تنظیم است، در ویجت درج شود.