Authentifizierung

Um die Endpunkte unserer APIs nutzen zu können, müssen Sie sich zuerst authentifizieren. Dieser Leitfaden erklärt, wie Sie Authentifizierungsdaten mit der Sheetize Cloud-Plattform erhalten und verwenden.

Hauptfunktionen

Der Authentifizierungsablauf von Sheetize Cloud ist darauf ausgelegt, Ihre Daten zu schützen und sicherzustellen, dass nur autorisierte Benutzer Dateien hochladen und unsere Dienste aufrufen können. Er bietet:

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.

So verwenden Sie

Eine Anwendung erstellen

Gehen Sie zu dem Dashboard
Nach dem Einloggen klicken Sie im linken Navigationsbereich auf den Menüpunkt **Anwendungen**.
Drücken Sie **Neue Anwendung erstellen**, um das Anwendungs‑Erstellungsformular zu öffnen.
Geben Sie im Abschnitt *Anwendungsdetails* einen beschreibenden Namen und eine kurze Beschreibung für Ihre Anwendung ein.
Klicken Sie auf die Schaltfläche **Speichern**, um die neue Anwendung zu speichern.
Suchen Sie in der Anwendungs‑Liste die gerade erstellte Anwendung und klicken Sie auf deren Namen.
Im Bereich *Client-Anmeldeinformationen* sehen Sie eine **Client-ID** und ein **Client‑Geheimnis** – bewahren Sie diese Werte sicher auf; sie werden benötigt, um ein Zugriffstoken zu erhalten.

Ein Zugriffstoken erhalten

Senden Sie eine Anfrage an die Authentifizierungs‑Endpunkt

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Nach der Ausführung erhalten Sie das Token; bitte speichern Sie es für die spätere Verwendung.

Endpunkte verwenden

Wählen Sie die API, die Sie aufrufen möchten. In diesem Beispiel zeigen wir den Konvertierungsservice, der Tabellendateien in das PDF-Format umwandelt.
Senden Sie eine Anfrage, die die Dateien und das Zugriffstoken enthält Konvertierungs‑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'
Der Service antwortet mit einer Download‑URL für das erzeugte PDF, in diesem Beispiel lautet sie:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Senden Sie eine Anfrage, die den Dateinamen und den Ordnernamen enthält, an Download‑API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Sie erhalten die Datei und können sie entweder verwenden oder einfach zum nächsten Schritt Ihres Workflows weiterleiten.