المرفقات
ارفع الملفات إلى 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} مجدداً للحصول على رابط جديد.