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

بارگذاری فایل

بارگذاری فایل (برای استفاده در پیام‌های چت)​

این سرویس برای بارگذاری فایل (تصویر یا فایل متنی پشتیبانی‌شده) جهت استفاده در پیام‌های چت به صورت درون‌خطی استفاده می‌شود.

مراحل استفاده​

  1. فایل خود را با استفاده از این سرویس بارگذاری کنید.
  2. شناسه فایل برگشتی را در فیلد files پیام چت استفاده نمایید.

مسیر سرویس​

POST /api/v1/b2b/agent/{agent_pk}/file/upload

فرمت‌های پشتیبانی‌شده​

  • تصویر: jpg، jpeg، png، gif، webp
  • متن: xlsx، xls، pdf، md، markdown، htm، html، docx، csv، epub، txt، py

پارامترهای مسیر (Path Parameters)​

نامنوعتوضیحات
agent_pkintegerشناسه دستیار (Agent)

هدرها (Headers)​

ناممقدارتوضیحات
AuthorizationToken api-tokenتوکن احراز هویت
Content-Typemultipart/form-dataنوع محتوای درخواست

بدنه درخواست (Request Body)​

نام فیلدنوعتوضیحات
fileفایلفایل موردنظر برای آپلود

نمونه فراخوانی​

curl --location 'https://app.houshyar24.ir/api/v1/b2b/agent/1/file/upload' \
--header 'Authorization: Token <your-token>' \
--form 'file=@"/docs.txt"'

پاسخ موفق (200)​

{
"upload_file_id": "string",
"file_name": "string",
"file_type": "file",
"transfer_method": "local_file",
"size": 12345
}