إضافة علامة مائية إلى ملفات Excel – مستندات Aspose.Cells Cloud

تقوم هذه الواجهة البرمجية REST بإضافة علامة مائية إلى ملفات Excel.

المتطلبات المسبقة: يجب الحصول على رمز وصول JWT صالح، وتأكد من أن ملف Excel بصيغة مدعومة (مثل .xlsx أو .xls).
الخلفية: العلامة المائية هي طبقة نصية شبه شفافة تُطبّق على كل ورقة عمل للإشارة إلى الملكية أو السرية.

واجهة PostWatermark API

POST https://api.aspose.cloud/v3.0/cells/watermark

الأمان والمصادقة

تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة قائمة على رمز JWT.

معاملات الطلب

اسم المعامل النوع الموقع الوصف
file ملف formData (جسم multipart) ملف Excel الذي سيتم تطبيق العلامة المائية عليه.
text نص استعلام النص المراد عرضه كعلامة مائية.
color نص استعلام لون العلامة المائية بصيغة سداسية ARGB (مثل 004433ff).

الاستجابة

تحتوي الاستجابة JSON على مصفوفة Files. بالنسبة لكائن كل ملف:

  • Filename – اسم ملف الكتاب المعالَج.
  • FileSize – حجم الملف بالبايت.
  • FileContent – المحتوى المُرمّز بـ Base64 لملف Excel الذي يحتوي على العلامة المائية؛ قم بفك التشفير للحصول على الملف الفعلي.
{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[اسم الملف1]",
            "Filesize" : [حجم الملف],
            "FileContent" : "[Base64String]"
        },        {
            "Filename" : "[اسم الملف2]",
            "Filesize" : [حجم الملف],
            "FileContent" : "[Base64String]"
        },        {
            "Filename" : "[اسم الملف3]",
            "Filesize" : [حجم الملف],
            "FileContent" : "[Base64String]"
        }
    ]
}

رموز حالة HTTP

الرمز المعنى الوصف
200 OK (تم بنجاح) تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 Bad Request (طلب غير صالح) معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401 Unauthorized (غير مصرّح) رمز JWT غير صالح أو مفقود.
413 Payload Too Large (حمولة كبيرة جداً) حجم الملف المرفوع يتجاوز الحد المسموح.
500 Internal Server Error (خطأ داخلي في الخادم) خطأ غير متوقع في الخادم.

كيفية استخدام واجهة PostWatermark API باستخدام SDKs

مواصفات واجهة PostWatermark API

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة عموماً، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمات Aspose.Cells. يُظهر المثال التالي طلباً كاملاً، بما في ذلك رأس المصادقة المطلوب. استبدل <your-jwt-token> برمز وصول JWT صالح تم الحصول عليه من نقطة نهاية مصادقة Aspose.

استخدام SDKs الخاصة بـ Aspose.Cells Cloud

استخدام SDK هو أسرع طريقة للتطوير. تقوم SDK بتجريد التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على منطق أعمالك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام مكتبات SDK مختلفة:

إضافة صورة خلفية إلى دفتر عمل