Clear
API شفافسازی صفحهگسترده به گونهای طراحی شده است که راه حل نهایی برای توسعهدهندگانی باشد که نیاز دارند بهصورت برنامهنویسی عناصر ناخواسته را از فایلهای صفحهگسترده در یک درخواست قابل اعتماد حذف کنند. این صفحه مستندات به عنوان راهنمای جامع شما عمل میکند و گام به گام تمام موارد مورد نیاز برای یکپارچهسازی سرویس در برنامههای شما را با اطمینان توضیح میدهد. ما با مرور کلی مفاهیم اصلی API آغاز میکنیم و توضیح میدهیم سرویس چگونه فرمتهای مختلف صفحهگسترده را تفسیر میکند—از فایلهای مدرن Office Open XML (.xlsx) گرفته تا باینریهای قدیمی اکسل (.xls) و همچنین Apple Numbers، CSV، TSV و بسیاری از نمایشهای جدولی دیگر. درک این تفاوتهای نوع‑فایل ضروری است، زیرا هر فرمت پیوندها، تصاویر، نمودارها و اشیای توکار را در ساختارهای متفاوتی ذخیره میکند؛ API Clear این پیچیدگیها را انتزاع میکند و یک رابط یکنواخت ارائه میدهد که در همهٔ این فرمتها کار میکند.
ویژگیهای اصلی
سپس یک راهنمای گامبهگام برای جریان کاری احراز هویت خواهید یافت. این پلتفرم از کلیدهای API استاندارد صنعتی و توکنهای اختیاری OAuth 2.0 استفاده میکند تا اطمینان حاصل شود فقط مشتریان مجاز میتوانند عملیات پاکسازی دادهها را فراخوانی کنند. بهترین شیوههای امنیتی مانند چرخش کلید، لیست سفید IP و انتقال رمزگذاریشدهٔ عبرت HTTPS بهصورت عمیق پوشش داده میشوند تا بتوانید زیرساخت خود و دادهٔ کاربران نهایی را محافظت کنید. پس از احراز هویت، بخش «شروع سریع» یک نمونه کد کوتاه‑شروع در زبانهای مختلف (cURL، Python، JavaScript، .NET و Java) ارائه میدهد که نشان میدهد چگونه payload درخواست را ساخته، فایل صفحهگسترده را ضمیمه و پاسخ را تفسیر کنید. این نمونه نشان میدهد که کوچکترین درخواست ممکن تنها شامل کلید API، دادهٔ فایل و یک فهرست اختیاری از نوع عناصر برای پاکسازی است—و وعدهٔ «یک فراخوانی ساده» API را به تصویر میکشد.
اسناد
پارامترها
- format: نام عملیات که میتواند باشد: clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
- AppRequest.OperationTables: نام عملیات که میتواند باشد: clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
- UploadFileRequest.OperationId: این یک شناسه عملیات است
- UploadFileRequest.Files: اینها فایلهایی هستند که باید به سرویسهای آنلاین ما آپلود کنید؛ میتوانید دادهها را به روش خودتان آماده کنید اما باید با استاندارد ورودی فایل HTML مطابقت داشته باشد.
از نقطه انتهایی استفاده کنید
-
درخواستی ارسال کنید که شامل فایلها و توکن دسترسی باشد Clear API
curl -X 'POST' \ 'https://api.sheetize.cloud/clear' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.OperationTables=clearHyperlinks' \ -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 } -
درخواستی ارسال کنید که شامل نام فایل و نام پوشه باشد به Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - فایل را دریافت خواهید کرد و میتوانید آن را استفاده کنید یا به سادگی به گام بعدی جریان کار خود انتقال دهید.
