# API-kulcsok

> Szolgáltatói REST API-kulcsok létrehozása, jogosultságaik beállítása, biztonságos másolása, kezelése és visszavonása az Integráció → API oldalon.

Canonical: https://komashi.com/docs/hu/provider/Settings/10api/
Language: hu

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](https://komashi.com/docs/hu/provider/Developers/mcp-integration/index.md) használd.

Video (English narration): [API-kulcsok](https://www.youtube.com/watch?v=NsTGVXPOLRk)

[![API-kulcsok: végpont, dokumentációhivatkozás és egy meglévő kulcs jogosultságai](https://komashi.com/docs/assets/images/integrations-api-keys.png)](/assets/images/integrations-api-keys.png)

## 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.

:::caution[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ó](https://komashi.com/docs/hu/provider/Developers/api-integration/index.md) útmutatóban `GET /services` példát, válaszkezelési leírást és aktuális végpont-áttekintést találsz.