استبدال
مرحبًا بكم في توثيق API للاستبدال — حل مبسط لتحويل محتوى ملفات جداول البيانات الخاصة بكم بطلب واحد قوي. سواء كنتم تعملون مع صيغ إكسل الشائعة (.xlsx, .xls, .xlsm)، أو ملفات CSV و TSV البسيطة، أو مستندات أبل نمبرز (.numbers)، فإن API الخاص بنا يتعامل معها جميعًا ويقدم واجهة موحدة لإجراء استبدالات نصية دقيقة. من خلال تعريف شروط مساواة واضحة، يمكنكم تحديد الخلايا التي يجب تعديلها وتزويد القيم الجديدة المطلوبة، مما يلغي التخمين والجهد اليدوي الذي يصاحب غالبًا تعديلات البيانات الضخمة. لذلك يُعد هذا API رفيقًا مثاليًا لمهام مثل تنظيف البيانات، حيث تحتاجون إلى تصحيح الأخطاء المتكررة عبر مجموعات بيانات كبيرة، أو مشاريع التعريب التي تتطلب استبدال منهجي للمصطلحات بحسب اللغة. تم تصميم فكرة الاستبدال لتكون سريعة، آمنة، وسهلة الاستخدام للمطورين، لتتمكنوا من دمج تعديل جداول البيانات في سير العمل الحالي دون التضحية بالأداء أو الأمان.
الميزات الرئيسية
إلى جانب قدراته الأساسية في الاستبدال، تم بناء API الاستبدال لمعالجة الواقع العملي للتعامل مع البيانات الحديثة. يعالج الملفات في الذاكرة قدر الإمكان، مما يقلل الحاجة إلى تخزين وسيط ويسرّع العمليات حتى على جداول البيانات الكبيرة. تضمن المصادقة القوية والنقل المشفر حماية بياناتكم الحساسة طوال العملية. تُوفر بنية رد الـ API ملاحظات واضحة حول الخلايا التي تم تعديلها، عدد الاستبدالات التي أُجريت، وأية صفوف لم تفي بالشروط المحددة، ما يمنحكم رؤية كاملة لعملية التحويل. سواءً كنتم تنظفون تفريغًا قديمًا للبيانات، تُعدون كتالوج منتجات لسوق جديد، أو تُ automatiséون تحديثات جداول البيانات المتكررة، فإن هذا API يمنحكم الثقة لإعادة تشكيل بياناتكم بموثوقية مع أقل قدر من الشيفرة وأقصى تحكم.
المستندات
المعلمات
- AppRequest.Replace: النص الذي تريد استبداله
- AppRequest.With: النص البديل
- UploadFileRequest.OperationId: معرف العملية هذا
- UploadFileRequest.Files: هذه هي الملفات التي تحتاج إلى رفعها إلى خدماتنا عبر الإنترنت؛ يمكنك إعداد البيانات بطريقتك الخاصة ولكن يجب أن يتبع معيار ملف الإدخال HTML.
-
إرسال طلب يتضمن الملفات ورمز الوصول API الاستبدال
curl -X 'POST' \ 'https://api.sheetize.cloud/replace' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Replace=TheTargetedText' \ -F 'AppRequest.With=TheText' \ -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 } -
إرسال طلب يتضمن اسم الملف واسم المجلد إلى API التنزيل
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - ستتلقى الملف ويمكنك إما استخدامه أو إرساله ببساطة إلى الخطوة التالية من سير العمل الخاص بك.
