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

آپلود media در چت دیوار (آزمایشی)

توجه

این API در حال حاضر در مرحله آزمایشی قرار دارد و ممکن است تغییرات آتی اعمال شود.

این فرایند شامل ۳ مرحله است، ابتدا باید توکن جهت دریافت دسترسی به آپلود را دریافت کنید. سپس باید با استفاده از توکن دریافتی فایل مدیا خود را آپلود کنید. و در نهایت با media_token دریافتی در چت مد نظر خود media خودتون رو بفرستید

نمای کلی

محدودیت‌های فایل

فرمت‌های مجاز

تصاویر: PNG, JPEG, JPG
فایل‌ها: PDF, DOC, DOCX, XLSX, XLS, PPTX, PPT
صدا: M4A, 3GP
ویدیو: MP4

محدودیت‌های حجم
  • تصاویر: حداکثر 5 مگابایت
  • فایل‌ها: حداکثر 5 مگابایت
  • صدا: حداکثر 1.5 مگابایت
  • ویدیو: حداکثر 50 مگابایت

مرحله ۱: دریافت توکن آپلود

ابتدا، شما نیاز دارید یک توکن آپلود دریافت کنید که برای مجوز آپلود رسانه شما استفاده خواهد شد.

Request

POST https://open-api.divar.ir/experimental/open-platform/chat/upload
Content-Type: application/json
x-api-key: {{apikey}}

Response

{
"token": "your_upload_token"
}

مرحله ۲: آپلود media

پس از دریافت upload_token، از آن برای آپلود فایل media خود استفاده کنید.

نکته

فایل باید به صورت form-data ارسال شود.

Request

POST https://chat.divar.ir/upload/{{media_type}}
Authorization: Bearer {{upload_token}}
Accept: */*
Content-Type: multipart/form-data

Body: فایل به صورت form-data

انواع media_type

media_type می‌تواند یکی از مقادیر زیر باشد: image, video, voice, file

Response

{
"id": "your_media_token",
"status": "ok"
}

مرحله ۳: استفاده از media_token در چت شما

در نهایت، از توکن رسانه در پیام‌های مکالمه خود استفاده کنید.

این کار با پر کردن فیلد media_token در object پیام انجام می‌شود.

{
"media_token": "your_media_token"
}
لینک‌های مرتبط
  • ارسال پیام با media در چت‌بات را می‌توانید در اینجا بخوانید.
  • ارسال پیام با media در چت را می‌توانید در اینجا بخوانید.