Otentikasi

Untuk mulai menggunakan endpoint API kami, Anda harus terlebih dahulu melakukan otentikasi. Panduan ini menjelaskan cara memperoleh dan menggunakan kredensial otentikasi dengan platform Sheetize Cloud.

Fitur Utama

Alur otentikasi Sheetize Cloud dirancang untuk melindungi data Anda dan memastikan bahwa hanya pengguna yang berwenang yang dapat mengunggah file dan memanggil layanan kami. Ini menyediakan:

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.

Cara Menggunakan

Buat aplikasi

Buka Dasbor
Setelah masuk, klik item menu **Applications** pada bilah navigasi sebelah kiri.
Tekan **Create New Application** untuk membuka formulir pembuatan aplikasi.
Di bagian *Application Details*, masukkan nama deskriptif dan deskripsi singkat untuk aplikasi Anda.
Klik tombol **Save** untuk menyimpan aplikasi baru.
Di daftar aplikasi, temukan yang baru saja Anda buat dan klik namanya.
Di panel *Client Credentials* Anda akan melihat **Client ID** dan **Client Secret** - simpan nilai-nilai ini dengan aman; mereka diperlukan untuk memperoleh token akses.

Dapatkan Token Akses

Kirim permintaan ke endpoint Authenticator

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Setelah eksekusi Anda akan menerima token, harap simpan untuk penggunaan selanjutnya

Gunakan endpoint

Pilih API yang ingin Anda panggil. Dalam contoh ini kami menunjukkan layanan Conversion, yang mengubah file spreadsheet menjadi format PDF.
Kirim permintaan yang menyertakan file dan token akses 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'
Layanan akan merespons dengan URL unduhan untuk PDF yang dihasilkan, dalam contoh ini adalah:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Kirim permintaan yang menyertakan nama file dan nama folder ke Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Anda akan menerima file dan dapat menggunakannya atau cukup meneruskannya ke langkah selanjutnya dalam alur kerja Anda.