Автентифікація

Щоб почати використовувати кінцеві точки наших 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**, щоб відкрити форму створення застосунку.
У розділі *Application Details* введіть описову назву та короткий опис вашого застосунку.
Натисніть кнопку **Save**, щоб зберегти новий застосунок.
У списку застосунків знайдіть створений щойно застосунок і натисніть його назву.
У панелі *Client Credentials* ви побачите **Client ID** та **Client Secret** — збережіть ці значення в безпеці; вони знадобляться для отримання токена доступу.

Отримати токен доступу

Зробіть запит до Authenticator endpoint

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Після виконання ви отримаєте токен, будь ласка, збережіть його для подальшого використання

Використовувати кінцеві точки

Виберіть API, який ви хочете викликати. У цьому прикладі ми демонструємо сервіс Conversion, який перетворює електронні таблиці у формат PDF.
Надішліть запит, який включає файли та токен доступу Conversion 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 }
Надішліть запит, який включає ім’я файлу та назву папки до Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Ви отримаєте файл і можете або використати його, або просто передати далі на наступний крок вашого процесу.