Doğrulama

API'lerimizin uç noktalarını kullanmaya başlamak için öncelikle kimlik doğrulaması yapmanız gerekir. Bu kılavuz, Sheetize Cloud platformu ile kimlik doğrulama kimlik bilgilerini nasıl elde edeceğinizi ve kullanacağınızı açıklar.

Ana Özellikler

Sheetize Cloud'un kimlik doğrulama akışı, verilerinizi korumak ve yalnızca yetkili kullanıcıların dosya yüklemesini ve hizmetlerimizi çağırmasını sağlamak için tasarlanmıştır. Şunları sağlar:

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.

Nasıl Kullanılır

Bir uygulama oluşturun

Şuraya gidin: Kontrol Paneli
Giriş yaptıktan sonra, sol menü çubuğunda **Uygulamalar** öğesine tıklayın.
**Yeni Uygulama Oluştur** düğmesine basarak uygulama oluşturma formunu açın.
*Uygulama Detayları* bölümünde, uygulamanız için açıklayıcı bir ad ve kısa bir açıklama girin.
Yeni uygulamayı kaydetmek için **Kaydet** düğmesine tıklayın.
Uygulamalar listesinde, yeni oluşturduğunuzu bulun ve adını tıklayın.
*Client Credentials* panelinde **Client ID** ve **Client Secret** göreceksiniz - bu değerleri güvende tutun; erişim tokenı almak için gereklidir.

Bir Erişim Tokenı Alın

Şu adrese bir istek gönderin: Authenticator uç noktası

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
İşlem tamamlandığında tokenı alacaksınız, lütfen daha sonra kullanmak üzere saklayın.

Uç noktaları kullanın

Çağırmak istediğiniz API'yi seçin. Bu örnekte, elektronik tablo dosyalarını PDF formatına dönüştüren Dönüştürme hizmetini gösteriyoruz.
Dosyaları ve erişim tokenını içeren bir istek gönderin Dönüştürme API'si

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'
Hizmet, oluşturulan PDF için bir indirme URL'si dönecek, bu örnekte:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Dosya adını ve klasör adını içeren bir istek gönderin: İndirme API'si

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Dosyayı alacaksınız ve onu kullanabilir ya da iş akışınızın bir sonraki adımına yönlendirebilirsiniz.