الملفات

تذهب الملفات إلى سيرفر الملفات أولًا، ثم تشير إليها الرسائل والصور والرموز التعبيرية بالمعرّف.

الرفع

curl -X POST "https://cdn.zrzur.com/attachments" \
  -H "x-bot-token: $ZRZUR_BOT_TOKEN" \
  -F "[email protected];type=text/csv"

الجواب هو { "id": "<file id>" }. أرسله في attachments داخل الرسالة، أو في avatar أو icon أو banner أو معرّف الرمز التعبيري.

لكل سيرفر حدوده، ويسردها GET / من الواجهة في features.limits. لا تُقبل إلا الصور ما عدا attachments. وتُرفض الملفات الفارغة (FileTooSmall)، وتحصل الملفات الكبيرة على FileTooLarge مع الحد. يتطلب الرفع رمز البوت، والوسم decorations لفريق زرزور فقط.

التنزيل

تُقدَّم الملفات من https://cdn.zrzur.com/{tag}/{file id}/{file name}. وللصور معاينات في /{tag}/{file id}.

بالمكتبة

const id = await bot.rest.uploadFile(
  "attachments",
  bytes,
  "report.csv",
  "text/csv",
);
await bot.messages.send(channelId, {
  content: "Report",
  files: [{ name: "report.csv", data: bytes, type: "text/csv" }],
});

يبني درس رفع الملفات الأمر /report.