اختر التمثيل الذي يناسب البيانات
يقبل إجراء رفع الكائن نصاً في `content` أو بيانات ثنائية مشفرة في `contentBase64`. يمكن تمرير نص مثل ملاحظة Markdown أو مستند JSON مباشرةً كمحتوى. أما ملفات PDF والصور والملفات الثنائية الأخرى، فيحافظ Base64 على تسلسل البايتات عندما تتوقع API قيمة نصية.
Base64 ترميز وليس تشفيراً أو ضغطاً. لا تشفر نصاً عادياً بترميز Base64 إلا إذا كان الإجراء يتطلب هذا التمثيل تحديداً. إذا أرسلت سلسلة Base64 في `content`، فقد يخزن الكائن أحرف الترميز نفسها بدلاً من الملف الثنائي الأصلي.
حافظ على النوع والمسار وسلامة المحتوى
اختر مفتاحاً يوضح غرض الملف وحدد نوع محتوى مناسباً، مثل `application/pdf` أو `image/png`، إذا كان العميل يدعم ذلك. يبين نوع المحتوى للبرامج كيفية تفسير الكائن ولا يغير البايتات. اجعل المفتاح والنوع متوافقين مع الملف الفعلي.
بعد الرفع، تحقق من المفتاح والحجم المعادين، ثم استرجع الكائن أو افتحه للتأكد من صلاحيته. قارن الحجم أو قيمة تحقق عند الحاجة إلى الحفاظ الدقيق على البيانات. تجنب تسجيل حمولة Base64 كاملة لأنها قد تكون كبيرة وتكشف محتوى ملف خاص؛ تكفي تفاصيل المفتاح والنوع والحجم ورسالة خطأ منقحة للتشخيص.