تبدیل
API متادیتا سرویس هدفمند و دوستانه برای توسعهدهندگان است که کنترل کامل بر متادیتای فایلهای صفحهگسترده را تنها با یک درخواست HTTP در اختیار شما میگذارد. چه با قالبهای کلاسیک اداری مانند Excel (.xlsx, .xls)، فایلهای سادهٔ با جداکننده مانند CSV (.csv) و TSV (.tsv)، یا حتی اسناد Apple Numbers (.numbers) سروکار داشته باشید، API پیچیدگیهای تجزیهٔ فایل را انتزاع میکند و به شما امکان میدهد که ویژگیهای توصیفی کلیدی را در عرض میلیثانیهها بخوانید، اضافه کنید یا اصلاح کنید. تصور کنید قادر باشید هزاران گزارش، مجموعهٔ دادهٔ تحقیقاتی یا صورتهای مالی را به صورت دستهای پردازش کنید و هر فایل را با مجموعهای ثابت از اطلاعات نویسنده، عناوین، موضوعات، توصیفات، فهرست کلیدواژهها و حتی مجموعهٔ برچسبهای سفارشی که برنامهٔ شما تعریف میکند، غنی کنید. این سطح از خودکارسازی نه تنها ساعتها وقت دستی را صرفهجویی میکند، بلکه تضمین میکند که هر فایلی که برای مشتریان، همکاران یا سیستمهای آرشیو میفرستید، دقیقاً متادیتای مورد نیاز برای ایندکسگذاری، انطباق و قابلیت کشف را داشته باشد. سرویس با پذیرش بایتهای خام فایل یا URLی که به سند میزبانیشده در ابر اشاره دارد، یک فایل جدید و کامل با تغییرات متادیتای درخواستشده برگردانده میشود بدون اینکه ساختار داده یا فرمولهای اصلی تغییر کنند.
ویژگیهای اصلی
از آنجا که API حالتدار نیست، میتوانید بهراحتی آن را در خطوط لوله CI/CD، کارهای دستهای سمت سرور یا ابزارکهای جاوااسکریپت سمتکاربر ادغام کنید و اطمینان حاصل کنید که هر خروجی از یک برنامه وب یا هر پشتیبانگیری دورهای شامل اطلاعات صحیح منبع باشد. امنیت بهصورت پیشفرض گنجانده شده است: تمام تماسها از طریق TLS انجام میشوند، payloadها بهصورت انتها‑به‑انتها رمزنگاری میشوند و API از احراز هویت با کلید API یا OAuth 2.0 پشتیبانی میکند، بهطوری که دسترسی تنها به سرویسهای مورد اعتماد محدود شود. موتور زیرساختی از کتابخانههای تجزیهٔ بهینهی بهینه برای هر قالب پشتیبانیشده استفاده میکند و تضمین میکند که حتی کتابکاریهای بزرگ Excel با صدها شیت به سرعت پردازش شوند؛ اکثر درخواستهای معمولی در کمتر از ۲۰۰ میلیثانیه تکمیل میشوند. در عمل این به این معنی است که میتوانید دکمهٔ «افزودن متادیتا» را بهصورت یکپارچه داخل محصول خود بسازید که فایل را به سرویس میفرستد، نسخهٔ غنیشده را دریافت میکند و بلافاصله برای دانلود ارائه میدهد—بدون اینکه کاربر از رابط کاربری خارج شود. API همچنین لاگهای عملیات دقیق را برمیگرداند تا توسعهدهندگان بتوانند برنامهنویسی فیلدهای بهروز شده را تأیید کنند، در صورت نیاز تغییرات را بازگردانند یا بر اساس مقادیر برچسب سفارشی گامهای پردازشی بعدی را فعال کنند. با ارائهٔ نقطهٔ انتهایی REST یکنواخت و بیزبان، API متادیتا نیاز به نگهداری کتابخانههای متعدد برای هر قالب را از بین میبرد، بار نگهداری را کاهش میدهد و سازگاری آیندهپذیر را با ظهور استانداردهای جدید صفحهگسترده تضمین میکند. چه بهعنوان یک فروشنده SaaS بخواهید اطلاعات مجوزدهی را تعبیه کنید، چه بهعنوان یک مؤسسهٔ تحقیقاتی دادهها را فهرست کنید یا یک شرکت بزرگ بهدنبال خودکارسازی انطباق اسناد باشد، این API روشی سریع، امن و مقیاسپذیر برای غنیسازی فایلهایتان با یک فراخوانی ساده فراهم میکند.
اسناد
پارامترها
- AppRequest.Metadata: با PropertyName و PropertyValue
- AppRequest.MetadataJson: اگر از ساختار Metadata استفاده نمیکنید، باید از نوع دادهٔ JSON استفاده کنید.
- UploadFileRequest.OperationId: اینها فایلهایی هستند که باید به سرویسهای آنلاین ما آپلود کنید؛ میتوانید دادهها را به روش خودتان آماده کنید، اما باید با استاندارد ورودی فایل html مطابقت داشته باشد.
- UploadFileRequest.Files: اینها فایلهایی هستند که باید به سرویسهای آنلاین ما آپلود کنید؛ میتوانید دادهها را به روش خودتان آماده کنید، اما باید با استاندارد ورودی فایل html مطابقت داشته باشد.
-
درخواستی ارسال کنید که شامل فایلها و توکن دسترسی باشد API متادیتا
curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -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' - فایل را دریافت خواهید کرد و میتوانید آن را استفاده کنید یا به سادگی به مرحلهٔ بعدی جریان کاری خود منتقل کنید.
