Hitelesítés
Az API-k végpontjainak használatának megkezdéséhez először hitelesítenie kell. Ez az útmutató bemutatja, hogyan szerezhet és használhat hitelesítési adatokat a Sheetize Cloud platformon.
Fő funkciók
A Sheetize Cloud hitelesítési folyamata úgy van kialakítva, hogy megvédje adatait, és biztosítsa, hogy csak a jogosult felhasználók tölthessenek fel fájlokat és hívhassák szolgáltatásainkat. Tartalmazza a következőket:
- 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.
Használat módja
Alkalmazás létrehozása
- Lépjen a Vezérlőpult
- Bejelentkezés után kattintson a bal oldali navigációs sáv **Alkalmazások** menüpontra.
- **Új alkalmazás létrehozása** gombnyomásával nyissa meg az alkalmazás létrehozási űrlapot.
- Az *Alkalmazás részletei* szakaszban adjon meg egy leíró nevet és egy rövid leírást az alkalmazásához.
- Kattintson a **Mentés** gombra az új alkalmazás mentéséhez.
- Az alkalmazások listájában keresse meg a most létrehozott elemet, és kattintson a nevére.
- *Ügyfél hitelesítő adatai* panelen látható egy **Client ID** és egy **Client Secret** – tartsa ezeket biztonságban; a hozzáférési token beszerzéséhez szükségesek lesznek.
Hozzáférési token beszerzése
-
Küldjön kérést a Hitelesítő végpont
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - A végrehajtás után megkapja a tokent, kérjük, tárolja későbbi használatra.
Végpontok használata
- Válassza ki a hívni kívánt API-t. Ebben a példában a Konverziós szolgáltatást mutatjuk be, amely táblázatfájlokat PDF formátumba konvertál.
-
Küldjön olyan kérést, amely tartalmazza a fájlokat és a hozzáférési tokent Konverziós 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' -
A szolgáltatás egy letöltési URL-t ad vissza a generált PDF-hez, ebben a példában ez:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 } -
Küldjön olyan kérést, amely tartalmazza a fájl nevét és a mappa nevét a következőhöz: Letöltési API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Megkapja a fájlt, amelyet felhasználhat vagy egyszerűen továbbíthatja a munkafolyamat következő lépésére.