العلامة المائية
مرحبًا بك في وثائق واجهة برمجة تطبيقات العلامة المائية — حل مبسط يتيح لك إدراج نص علامة مائية مخصص مباشرةً في مجموعة واسعة من صيغ جداول البيانات بطلب واحد سهل للمطورين. سواءً كنت تتعامل مع ملفات مايكروسوفت إكسل (.xlsx, .xls, .xlsm)، أو ملفات CSV و TSV التقليدية، أو أبل نمبرز (.numbers)، أو العديد من الأنواع المدعومة الأخرى، فإن واجهتنا تتولى العبء الثقيل نيابةً عنك. ما عليك سوى تحميل الملف الأصلي، وتزويدنا بنص العلامة المائية المطلوب، ثم تسمح لخدماتنا الآمنة وعالية الأداء بإرجاع نسخة موسومة جاهزة للتوزيع. هذه القدرة مثالية لإضافة شعارات العلامة التجارية، معرفات النسخة، إشعارات السرية، أو أي تسمية مخصصة تعزز التحكم في المستندات والأصالة عبر مؤسستك.
الميزات الرئيسية
صُممت بسرعتها وأمانها في جوهرها، تتكامل واجهة برمجة تطبيقات العلامة المائية بسلاسة مع أي سير عمل موجود، سواء كنت تبني منصة SaaS سحابية، أو أداة إدارة ملفات داخلية، أو خط أنابيب تقارير مؤتمت. تدعم نقطة النهاية تحميلات متعددة الأجزاء، وتتحقق من سلامة الملف، وتطبق العلامة المائية بدقة، مما يضمن بقاء تخطيط البيانات الأصلي دون تغيير بينما يكون النص المضاف واضحًا للظهور. لأنها بُنيت للمطورين، ستجد رسائل خطأ واضحة، رموز استجابة شاملة، وأمثلة طلبات مفصلة عبر هذا الدليل. استكشف كيف يمكن لاستدعاء API واحد أن يحمي جداول البيانات الخاصة بك، يعزز اتساق العلامة التجارية، ويسهل إدارة دورة حياة المستند.
المستندات
المعلمات
- AppRequest.WatermarkText: إذا كنت تريد استخدام تعبئة لون RGB لهذا الإدخال، يرجى استخدام لون Hex بدلاً من ذلك
- AppRequest.WatermarkColorHex: إذا كنت تريد استخدام تعبئة لون RGB لهذا الإدخال، يرجى استخدام لون Hex بدلاً من ذلك
- AppRequest.WatermarkTextRGB: إذا كنت تريد استخدام تعبئة لون RGB لهذا الإدخال، يرجى استخدام لون Hex بدلاً من ذلك
- UploadFileRequest.OperationId: هذا هو معرّف العملية
- UploadFileRequest.Files: هذه هي الملفات التي تحتاج إلى تحميلها إلى خدماتنا عبر الإنترنت، يمكنك إعداد البيانات بطريقتك الخاصة لكن يجب أن تتبع معيار ملف إدخال HTML.
-
أرسل طلبًا يتضمن الملفات ورمز الوصول واجهة برمجة تطبيقات العلامة المائية
curl -X 'POST' \ 'https://api.sheetize.cloud/watermark' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.WatermarkText=TheWatermarkText' \ -F 'AppRequest.WatermarkColorHex=ff0000' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
ستستجيب الخدمة بعنوان URL للتنزيل للملف المعالج، في هذا المثال هو:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
أرسل طلبًا يتضمن اسم الملف واسم المجلد إلى واجهة برمجة تطبيقات التنزيل
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - ستستلم الملف ويمكنك إما استخدامه أو ببساطة إرساله إلى الخطوة التالية في سير عملك.
