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

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

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

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

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

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

مسیر سرویس

POST /api/v1/core/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/core/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
}