المرفقات

ارفع الملفات إلى AgentSend وأرفقها بالرسائل الصادرة. استرجع روابط مُوقَّعة مسبقاً لتنزيل أو مشاركة محتوى المرفقات.

💡

ارفع المرفق أولاً، ثم أشر إلى id الخاص به في حقل attachmentIds عند إرسال الرسالة. تُخزَّن المرفقات بأمان وتُتاح عبر روابط مُوقَّعة مسبقاً محدودة الزمن.

رفع مرفق

POST /attachments

يرفع ملفاً ويُرجع كائن Attachment. استخدم id المُرجَع لإرفاق الملف برسالة. يجب أن يستخدم الطلب ترميز multipart/form-data.

جسم الطلب

Content-Type: multipart/form-data

الحقل النوع الوصف
file مطلوب file الملف المطلوب رفعه. يُستنتَج اسم الملف ونوع المحتوى من الجزء المرفوع.

مثال على الطلب

bash
curl -X POST https://api.agentsend.io/attachments \
  -H "x-api-key: $AGENTSEND_API_KEY" \
  -F "file=@/path/to/report.pdf"
javascript
const form = new FormData();
form.append("file", fileBlob, "report.pdf");

const res = await fetch("https://api.agentsend.io/attachments", {
  method: "POST",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
  body: form,
});

const attachment = await res.json();
console.log(attachment.id); // use this id when sending a message

الاستجابة — 201 Created

json
{
  "id": "att_01j9zxkp4qbc7n3m8td5e6fvg2",
  "filename": "report.pdf",
  "contentType": "application/pdf",
  "size": 204800,
  "url": "https://storage.agentsend.io/att_01j9zxkp4qbc7n3m8td5e6fvg2/report.pdf?token=...",
  "createdAt": "2025-11-10T08:15:00Z"
}

الحصول على مرفق

GET /attachments/{id}

يسترجع البيانات الوصفية ورابط تنزيل مُوقَّع مسبقاً قصير الأمد لمرفق. استخدم حقل url لتنزيل أو عرض محتوى الملف مباشرةً.

معاملات المسار

المعامل Type Description
id مطلوب uuid معرّف المرفق المطلوب استرجاعه.

مثال على الطلب

bash
curl https://api.agentsend.io/attachments/att_01j9zxkp4qbc7n3m8td5e6fvg2 \
  -H "x-api-key: $AGENTSEND_API_KEY"

الاستجابة — 200 OK

json
{
  "id": "att_01j9zxkp4qbc7n3m8td5e6fvg2",
  "filename": "report.pdf",
  "contentType": "application/pdf",
  "size": 204800,
  "url": "https://storage.agentsend.io/att_01j9zxkp4qbc7n3m8td5e6fvg2/report.pdf?token=...",
  "createdAt": "2025-11-10T08:15:00Z"
}

كائن Attachment

Field Type Description
id string المعرّف الفريد للمرفق.
filename string اسم الملف الأصلي كما قُدّم عند الرفع.
contentType string نوع MIME للملف (مثل application/pdf أو image/png).
size number حجم الملف بالبايتات.
url string رابط مُوقَّع مسبقاً لتنزيل الملف. هذا الرابط محدود الزمن؛ اجلب رابطاً جديداً باستدعاء هذه النقطة مجدداً إذا انتهت صلاحيته.
createdAt string طابع ISO 8601 لوقت رفع المرفق.

تنتهي صلاحية الروابط المُوقَّعة مسبقاً بعد فترة قصيرة. إذا احتجت لمشاركة أو إعادة تنزيل مرفق، استدعِ GET /attachments/{id} مجدداً للحصول على رابط جديد.