احراز هویت
برای شروع استفاده از نقاط انتهایی APIهای ما، ابتدا باید احراز هویت کنید. این راهنما توضیح میدهد چگونه موجودیتهای احراز هویت را دریافت و استفاده کنید با پلتفرم Sheetize Cloud.
ویژگیهای اصلی
جریان احراز هویت Sheetize Cloud به گونهای طراحی شده است که دادههای شما را محافظت کند و اطمینان حاصل شود که تنها کاربران مجاز میتوانند فایلها را بارگذاری کنند و سرویسهای ما را فراخوانی کنند. این موارد را فراهم میکند:
- Secure, token-based access that can be revoked at any time.
- Support for both machine-to-machine and user-driven scenarios.
- Granular scopes that let you limit what a token can do.
نحوه استفاده
ایجاد یک برنامه
- به درخواست شامل نام فایل و نام پوشه را به
- بعد از ورود، گزینه منوی **Applications** را در نوار ناوبری سمت چپ کلیک کنید.
- دکمه **Create New Application** را فشار دهید تا فرم ایجاد برنامه باز شود.
- دکمه **Save** را کلیک کنید تا برنامه جدید ذخیره شود.
- دکمه **Save** را کلیک کنید تا برنامه جدید ذخیره شود.
- در پنل *Client Credentials* یک **Client ID** و یک **Client Secret** خواهید دید - این مقادیر را ایمن نگه دارید؛ برای دریافت توکن دسترسی به آنها نیاز خواهید داشت.
- در پنل *Client Credentials* یک **Client ID** و یک **Client Secret** خواهید دید - این مقادیر را ایمن نگه دارید؛ برای دریافت توکن دسترسی به آنها نیاز خواهید داشت.
دریافت یک توکن دسترسی
-
یک درخواست به نقطه انتهایی Authenticator
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - پس از اجرا توکن را دریافت میکنید، لطفاً برای استفاده بعدی آن را ذخیره کنید.
استفاده از نقاط انتهایی
- API مورد نظر خود را برای فراخوانی انتخاب کنید. در این مثال سرویس تبدیل را نشان میدهیم که فایلهای صفحهگسترده را به فرمت PDF تبدیل میکند.
-
درخواستی بفرستید که شامل فایلها و توکن دسترسی باشد API تبدیل
curl -X 'POST' \ 'https://api.sheetize.cloud/conversion/to-pdf' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer The_Secret_Access_Token \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@TestFile.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
سرویس با یک URL دانلود برای PDF تولید شده پاسخ میدهد، در این مثال آن عبارت است از:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 } -
درخواست شامل نام فایل و نام پوشه را به HowToUse111
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - فایل را دریافت خواهید کرد و میتوانید یا از آن استفاده کنید یا به سادگی به گام بعدی جریان کار خود ارسال کنید.