Аутентификация

Чтобы начать использовать конечные точки наших 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

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; в этом примере это:

{ "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'
Вы получите файл и сможете либо использовать его, либо просто передать на следующий этап вашего рабочего процесса.