احراز هویت

ویژگی‌های اصلی

• 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** را فشار دهید تا فرم ایجاد برنامه باز شود.
• در بخش *Application Details*، یک نام توصیفی و توضیح کوتاهی برای برنامه خود وارد کنید.
• دکمه **Save** را کلیک کنید تا برنامه جدید ذخیره شود.
• در فهرست برنامه‌ها، برنامه‌ای که تازه ایجاد کرده‌اید را پیدا کنید و روی نام آن کلیک کنید.
• در پنل *Client Credentials* یک **Client ID** و یک **Client Secret** مشاهده خواهید کرد - این مقادیر را احتیاطاً نگهدارید؛ برای دریافت توکن دسترسی به آن‌ها نیاز دارید.

دریافت یک توکن دسترسی

• درخواست به نقطه انتهایی Authenticator
  https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
• پس از اجرا توکن را دریافت خواهید کرد؛ لطفاً برای استفاده بعدی آن را ذخیره کنید

استفاده از نقاط انتهایی

• API مورد نظر خود را برای فراخوانی انتخاب کنید. در این مثال سرویس Conversion را نشان می‌دهیم که فایل‌های صفحه‌گسترده را به فرمت 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 تولید شده پاسخ می‌دهد؛ در این مثال URL به صورت زیر است:

  { "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
• درخواست حاوی نام فایل و نام پوشه را به API دانلود

  curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
• فایل را دریافت خواهید کرد و می‌توانید یا آن را استفاده کنید یا به سادگی به مرحله بعدی جریان کاری خود ارسال کنید.