---
title: "API-kulcsok"
description: "Hozd létre, kösd csatornákhoz, vond vissza és töröld a webáruház-felületek publikus API-kulcsait."
url: "https://docs.poltura.com/hu/developer/api-keys/"
lang: hu
alternates:
  en: "https://docs.poltura.com/en/developer/api-keys/"
  hu: "https://docs.poltura.com/hu/developer/api-keys/"
---

# API-kulcsok

Hozd létre, kösd csatornákhoz, vond vissza és töröld a webáruház-felületek publikus API-kulcsait.

- Hol: Beállítások → Fejlesztő → Publikus API Kulcsok
- Állapot: Fejlesztői mód

Ez az oldal csak bekapcsolt [fejlesztői mód](https://docs.poltura.com/hu/developer/) mellett jelenik meg.

A **publikus** API-kulcs egy webáruház-felületet azonosít. Nyilvános, szerepelhet egy weboldal kódjában. Ez dönti el, mely [értékesítési csatornákat](https://docs.poltura.com/hu/developer/sales-channels/) látja az adott felület. A kulcsokat a **Beállítások → Fejlesztő → Publikus API-kulcsok** listában találod.

Erre az oldalra akkor van szükséged, ha saját webáruház-felületet építesz. Háttérrendszer bekötéséhez API-tokent használj. Személyeset a Poltura ID-ban a **Fiók → API-tokenek** alatt hozhatsz létre, szervezetit a **Beállítások → Szervezet → API és hozzáférés** alatt. A token csak azokat a jogosultságokat és áruházakat éri el, amelyeket kiválasztasz.

![A Publikus API kulcsok lista egy aktív kulccsal, a részben elrejtett tokennel és a létrehozás dátumával, fent a Létrehozás gomb](https://docs.poltura.com/screenshots/hu/developer/api-keys.webp)

_A listában csak a tokenek eleje és vége látszik._

> **Jó tudni**
>
> Ezeken az oldalakon több felirat (például a mezők neve és a hibaüzenetek) magyar admin mellett is angolul jelenik meg. Az útmutató úgy idézi őket, ahogy a képernyőn látod.

## Mielőtt elkezdenéd

Olyan szerepkör kell, amely az áruház beállításait is tartalmazza, például Tulajdonos, Adminisztrátor vagy Boltkezelő.

## Publikus kulcs létrehozása

1. Nyisd meg a **Beállítások** oldalt, és a **Fejlesztő** csoportban válaszd a **Publikus API Kulcsok** menüpontot.
2. Kattints a **Létrehozás** gombra.
3. A **Title** mezőbe írj egy címet, amelyből kiderül, mire való a kulcs, majd mentsd.
4. Megnyílik az új kulcs adatlapja. A **Token** sorban a teljes kulcs látható másolás gombbal és a **Nyilvános, webáruházban használható** megjegyzéssel.
5. Az értékesítési csatornák részében válaszd az **Értékesítési csatornák szerkesztése** lehetőséget.
6. Jelöld be azokat a csatornákat, amelyeket a kulcs elérhet, majd mentsd.
7. A rész ezután felsorolja a csatornákat. Az a felület, amely ezt a kulcsot küldi, csak ezeknek a csatornáknak a termékeit látja.

Az adatlapot bármikor újra megnyithatod, és kimásolhatod a tokent. A publikus token a létrehozás után sem tűnik el.

> **Figyelem**
>
> Az a publikus kulcs, amelyhez nem tartozik értékesítési csatorna, nem működik: az áruház elutasítja a vele küldött termékkéréseket. Mielőtt használnád a kulcsot, kösd hozzá legalább egy csatornát.

## Kulcs átnevezése

1. Nyisd meg a kulcsot a listájából.
2. Válaszd az **API-kulcs szerkesztése** lehetőséget.
3. Írd át a **Title** mezőt, majd mentsd.

Az átnevezés nem érinti a tokent, a hozzákötött csatornákat és a kulcs állapotát.

## Kulcs visszavonása

Vond vissza a kulcsot, ha kiszivárgott, vagy ha megszűnt az integráció, amely használta.

> **Figyelem**
>
> Minden, ami még ezt a kulcsot használja, azonnal leáll. A visszavont kulcs nem állítható vissza.

1. Nyisd meg a kulcsot a listájából.
2. Az adatlap alján, a visszavonásról szóló részben válaszd az **API kulcs visszavonása** lehetőséget.
3. A megerősítéshez írd be a kulcs címét pontosan úgy, ahogy szerepel.
4. Erősítsd meg a visszavonást.
5. A kulcs állapota visszavontra vált, az adatlapon pedig megjelenik, mikor és ki vonta vissza.

Ha kiesés nélkül szeretnél kulcsot cserélni, előbb hozz létre egy másodikat, kösd hozzá ugyanazokat a csatornákat, állítsd át rá a felületet, és csak ezután vond vissza a régit. Egyszerre több aktív kulcs is létezhet.

## Kulcs törlése

Csak visszavont kulcs törölhető. A törlés végleg eltávolítja a listából.

1. Nyiss meg egy visszavont kulcsot.
2. Az adatlap alján válaszd az **API-kulcs törlése** lehetőséget.
3. Írd be a kulcs címét, és erősítsd meg.
4. Visszakerülsz a listára, a kulcs pedig eltűnt.

## Jó tudni

- A listák oszlopai: **Title**, **Token** (rövidítve), **Status**, **Last Used At** és **Created**. Cím szerint kereshetsz, és szűrhetsz a létrehozás, a módosítás és a visszavonás dátumára.
- A **Last Used At** oszlop egyelőre üres marad. Ne ebből döntsd el, hogy egy kulcs használatban van-e még.
- A létrehozó és a visszavonó helyén technikai azonosító áll, nem a munkatárs neve.
- Két kulcsnak lehet ugyanaz a címe. Adj mindegyiknek saját címet, mert a visszavonáshoz és a törléshez be kell írnod.
- A cím legfeljebb 200 karakter lehet.
- Publikus kulcs soha nem ad adminhozzáférést.

## Ha valami nem működik

- **„An API key has to be revoked before it can be deleted.”** Előbb vond vissza a kulcsot.
- **„That does not match, so nothing was changed.”** A beírt cím eltér a kulcs mostani címétől. Figyelj a kis- és nagybetűkre, és nézd meg, nem nevezte-e át valaki a kulcsot.
- **„That API key could not be found”.** A kulcsot törölték, másik áruházhoz tartozik.
- **Egy webáruház-felület nem tölti be a termékeket.** A kulcsát visszavonták, vagy nincs hozzákötve értékesítési csatorna.

## Kapcsolódó oldalak

- [Fejlesztői mód](https://docs.poltura.com/hu/developer/)
- [Értékesítési csatornák](https://docs.poltura.com/hu/developer/sales-channels/)
- [Saját alkalmazások](https://docs.poltura.com/hu/developer/apps/)
- [Felhasználók és szerepkörök](https://docs.poltura.com/hu/settings/organization/team/#roles)