Authenticatie
Om de eindpunten van onze API's te gebruiken, moet u zich eerst authenticeren. Deze gids legt uit hoe u authenticatiegegevens kunt verkrijgen en gebruiken met het Sheetize Cloud-platform.
Belangrijkste functies
De authenticatiestroom van Sheetize Cloud is ontworpen om uw gegevens te beschermen en ervoor te zorgen dat alleen geautoriseerde gebruikers bestanden kunnen uploaden en onze diensten kunnen aanroepen. Het biedt:
- 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.
Hoe te gebruiken
Maak een toepassing
- Ga naar de Dashboard
- Nadat u bent ingelogd, klikt u op het menu-item **Applications** in de navigatiebalk aan de linkerkant.
- Druk op **Create New Application** om het formulier voor het aanmaken van een toepassing te openen.
- Voer in de sectie *Application Details* een beschrijvende naam en een korte beschrijving voor uw toepassing in.
- Klik op de knop **Save** om de nieuwe toepassing op te slaan.
- Zoek in de lijst met toepassingen de zojuist gemaakte en klik op de naam.
- In het paneel *Client Credentials* ziet u een **Client ID** en een **Client Secret** - bewaar deze waarden veilig; ze zijn nodig om een toegangstoken te verkrijgen.
Verkrijg een toegangstoken
-
Doe een verzoek naar de Authenticator-eindpunt
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - Na de uitvoering ontvangt u het token, sla het op voor later gebruik
Gebruik de eindpunten
- Kies de API die u wilt aanroepen. In dit voorbeeld demonstreren we de Conversiedienst, die spreadsheet‑bestanden omzet naar PDF-formaat.
-
Stuur een verzoek dat de bestanden en het toegangstoken bevat Conversie‑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' -
De dienst reageert met een download‑URL voor de gegenereerde PDF, in dit voorbeeld is dat:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 } -
Stuur een verzoek dat de bestandsnaam en de mapnaam bevat naar Download‑API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - U ontvangt het bestand en kunt het gebruiken of simpelweg doorsturen naar de volgende stap van uw workflow.