API-kulcsok

Nyisd meg a szolgáltató Vezérlőközpont → Integráció → API oldalát. Az API-kulcsok felületen az ehhez a szolgáltatóhoz tartozó REST-integrációk hozzáféréseit kezeled. AI-asszisztenshez a külön OAuth MCP-kapcsolatot használd.

Dokumentáció és végpont

Az oldal tetején:

• a Dokumentáció az interaktív API-referenciát nyitja meg;
• az API-végpont a REST-kérések alapcímét mutatja, a /v1 előtaggal együtt.

A saját környezetedben megjelenő értékeket használd. A képernyőképen szereplő helyi végpont bemutatóadat; ne ezt másold egy éles integrációba.

Új kulcs létrehozása

1. Kattints az Új API-kulcs gombra.
2. A Kulcs neve mezőbe írj beszédes nevet, például Számlázási szinkron — éles.
3. Válaszd ki a szükséges jogosultságokat.
4. Kattints a Kulcs létrehozása gombra.
5. A generált értéket a párbeszédablak bezárása előtt másold át az integráció szerveroldali titokbeállításába.

A teljes kulcs csak közvetlenül a létrehozás után látható. A listából később nem lehet kiolvasni. Elveszett kulcs helyett hozz létre újat, és frissítsd az integrációt.

Jogosultságok kiválasztása

Új kulcsnál alapértelmezetten az Olvasás van kijelölve.

Jogosultság	Példák
Olvasás / Read	Szolgáltatások és ügyfelek listázása, számlák lekérdezése, felhasználás ellenőrzése.
Létrehozás / Create	Ügyfél, kapcsolattartó vagy előfizetési fizetési folyamat létrehozása.
Frissítés / Update	Rekordok módosítása, felhasználás szinkronizálása vagy változtatása, csomagváltás, előfizetés lemondása.
Törlés / Delete	Támogatott erőforrások, például ügyfelek vagy kapcsolattartók törlése.

A jogosultság az adott művelet követelménye. Például az előfizetés lemondásához Frissítés kell, bár a HTTP-metódusa DELETE.

Legalább egy jogosultság maradjon kijelölve

A jelenlegi űrlap üres jogosultságválasztás mentésekor teljes hozzáférést / Full access ad. Ez nem hozzáférés nélküli kulcsot hoz létre. Jelöld ki a szükséges műveleteket, majd a listában is ellenőrizd a megjelenő jogosultságokat.

Minden szerveroldali integrációhoz külön kulcsot használj, így egy kulcs cseréje vagy törlése nem állít le más rendszereket.

Meglévő kulcs kezelése

A listában a név, a jogosultságok, az utolsó használat, a létrehozás ideje és a műveletgombok láthatók. A Még nem használták azt jelzi, hogy még nincs rögzített használat; önmagában nem igazolja, hogy az integráció helyesen van beállítva.

A jogosultságokhoz kattints a kulcs fogaskerék ikonjára, módosítsd a kijelölést, és mentsd el. Ez a meglévő kulcs hozzáférését változtatja meg. Mentés után ellenőrizd újra a listát.

Kulcs cseréje vagy visszavonása

A felesleges leállás elkerüléséhez:

1. Hozz létre egy új kulcsot a szükséges jogosultságokkal.
2. Frissítsd az integráció szerveroldali titokbeállítását.
3. Ellenőrizd, hogy az integráció működik az új kulccsal.
4. A régi kulcsnál kattints a kuka ikonra, és erősítsd meg az API-token törlését.

A törlés végleges visszavonás: a régi kulccsal küldött kérések többé nem hitelesíthetők. Ez az adott szolgáltatói REST-kulcsra vonatkozik. A fiókszintű MCP-kapcsolatokat a Beállítások → MCP részben kezelheted.

Első API-kérés

A REST API-integráció útmutatóban GET /services példát, válaszkezelési leírást és aktuális végpont-áttekintést találsz.