API | Yaplet HU

Mi az az API kulcs?

Az API kulcs egy biztonságos token, amely teljes hozzáférést biztosít a Yaplet szervezeted adataihoz és funkcióihoz. Minden API híváshoz szükséges, és biztonságosan kell tárolni.

Legfontosabb tudnivalók

Szervezet szintű: A szervezetednek legfeljebb 10 elnevezett kulcsa lehet, megosztva a csapatodban — mindegyik egyszerre működik
Egyszeri megjelenítés: A kulcs titkos értéke csak egyszer jelenik meg, a létrehozáskor — mentsd el azonnal
Teljes hozzáférés: Minden kulcs teljes hozzáférést biztosít a fiókod adataihoz a Yaplet API-jain keresztül. Az, hogy egy AI alkalmazás használhatja-e a kulcsot, külön beállítás, az AI hozzáférés (MCP), amely kikapcsolva indul
Minden csomagon: az API kulcsok az ingyenes alap részei — nem kell fizetős csomag ahhoz, hogy létrehozz egyet

Az API-hozzáférés mostantól minden csomagban benne van, az ingyenesben is. Korábban csak a Growth csomag része volt, ami azt jelentette, hogy egy Starter ügyfél, aki kulcsot igénylő modult vásárolt — partnerprogram-követés, AI közösségi posztolás, hírlevél-munkafolyamatok —, nem tudott kulcsot létrehozni. A meglévő szervezetek automatikusan megkapták a jogosultságot; nincs mit megvenni és nincs mit bekapcsolni.

Attól, hogy létre tudsz hozni kulcsot, még nem kapsz funkciókat. Minden végpont, amit egy kulcs elér, továbbra is ellenőrzi a saját jogosultságát, így egy ingyenes szervezet kulcsa pontosan azt nyitja meg, amije a szervezetnek már amúgy is megvan.

API kulcsok kezelése

Menj a Beállítások → Szervezeti beállítások → API menüpontra (a képernyő címe maga API Kulcsok). A kulcsaid egy táblázatban jelennek meg, amely mutatja minden kulcs nevét, a végződését (yAPI_… plusz a titkos érték utolsó 6 karaktere, így össze tudod vetni a konfigurációdban lévő kulccsal), a létrehozás dátumát, azt, hogy mikor használták utoljára, és az AI hozzáférés (MCP) beállítását.

Az Utoljára használva oszlop azt mutatja, mikor érkezett utoljára kérés a kulccsal. Minden kérés számít, amelyik a kulcsot hozza, akkor is, ha a Yaplet utána elutasította. Legfeljebb 15 percenként frissül, így egy sűrűn használt kulcsnál az idő akár 15 perccel régebbi is lehet. Az a kulcs, amelyet az oszlop bevezetése óta nem használtak, a Még nincs adat feliratot mutatja.

Kulcsot csak a szervezet tulajdonosa hozhat létre és törölhet. Egy kulcs az egész szervezet nevében működik, ezért a többi csapattag, aki megnyithatja ezt az oldalt, a listát és egy erről szóló tájékoztatást lát — Új API Kulcs gombot és törlés műveletet nem.

Kulcs létrehozása

Kattints az „Új API Kulcs” gombra
Adj a kulcsnak egy nevet, ami leírja, mire fogod használni — pl. Éles szerver (kötelező)
Másold és mentsd el a titkos értéket azonnal — később nem lehet lekérni; a Yaplet csak egy lenyomatát tárolja
A kulcsok yAPI_ előtaggal rendelkeznek a könnyű azonosítás érdekében

Hozz létre külön kulcsot minden integrációhoz. Így később bármelyik kulcsot törölheted anélkül, hogy a többi integráció leállna.

Kulcs törlése

A törléshez be kell gépelned a kulcs nevét megerősítésként. A kulcs azonnal megszűnik működni, és nem állítható vissza — minden, ami még használja, hibát fog kapni.

Ha kiesés nélkül szeretnél kulcsot cserélni: hozz létre egy új kulcsot, állítsd át rá az integrációdat, majd töröld a régit.

A névvel ellátott kulcsok bevezetése előtt létrehozott kulcsok neve Default API key, és a soruk csak egy sima yAPI_…-t mutat — a végződésük sosem lett eltárolva.

API kulcs használata

Add meg bármelyik API kulcsodat a Y-API-Key fejlécben minden API kérésnél:

Y-API-Key: yAPI_your_generated_key_here

API felhasználási esetek

Az API kulcsaid különböző integrációkat tesznek lehetővé, például:

Affiliate követés - Ajánlások és jutalékok rögzítése
Hírlevél feliratkozó kezelés - Névjegyek tömeges importálása és frissítése
E-mail automatizálás indítása - Egy e-mail automatizálás elindítása egy névjegyre programozottan
Egyedi integrációk - Yaplet összekapcsolása a meglévő rendszereiddel

Részletes API dokumentáció minden végponthoz elérhető a megfelelő dokumentációs oldalakon:

AI hozzáférés (MCP)

Az API kulcs az egyik módja annak is, hogy egy AI alkalmazás az MCP szerveren keresztül csatlakozzon a fiókodhoz. Az AI hozzáférés (MCP) oszlop kulcsonként dönti el, hogy ez megengedett-e, és mennyit tehet az AI:

Beállítás	Mit tehet egy AI alkalmazás ezzel a kulccsal
Kikapcsolva	Semmit — az AI alkalmazást elutasítjuk. A kulcs a Yaplet többi API-jával továbbra is működik.
Csak olvasás	Utánanéz a dolgoknak. Semmit nem változtat meg.
Olvasás és módosítás	Ezen felül létrehozhat és módosíthat olyan dolgokat, amelyek visszaállíthatók.
Olvasás, módosítás, törlés és küldés	Ezen felül véglegesen törölhet egy elemet, vagy üzenetet küldhet valakinek a csapatodon kívül.

Az új kulcsok kikapcsolva indulnak. Csak annál a kulcsnál kapcsold be az AI hozzáférést, amelyet tényleg AI alkalmazással használsz.
A kulcs annak a nevében fut, aki bekapcsolta. Az AI így csak azt teheti, amit ez a személy most megtehet az irányítópulton. A sor mutatja, kinek a nevében fut — … nevében fut. Ha ezt a személyt letiltják, a kulcs AI hozzáférése leáll, amíg vissza nem kapcsolják; ha eltávolítják a szervezetből, végleg leáll — a sorban ekkor Egy eltávolított tag nevében fut áll, és mivel csak a kulcs létrehozója kapcsolhatja be, a szervezet tulajdonosa hoz létre helyette új kulcsot.
Az AI hozzáférést csak a kulcs létrehozója kapcsolhatja be, illetve csak ő módosíthatja a szintjét, így senki nem teheti egy kolléga kulcsát olyan AI kulccsá, amely az ő nevében fut. Kikapcsolni a kulcs létrehozója vagy a szervezet tulajdonosa tudja, így egy kolléga kulcsán futó AI alkalmazást sem vághat le senki. Ha egy kulcsot nem módosíthatsz, a beállítás szürkén jelenik meg, és kiírja, ki módosíthatja. Azoknál a kulcsoknál, amelyek még a létrehozó rögzítése előtt készültek, csak a szervezet tulajdonosa kapcsolhatja be.
Régebbi kulcsok: az e beállítás előtt létező kulcsok megtartották a teljes AI hozzáférést, és a szervezet tulajdonosának nevében futnak (A szervezet tulajdonosának nevében fut). Ha egy ilyen kulcsot nem használsz AI alkalmazással, kapcsold ki az AI hozzáférését.
A beállítás minden módosítása bekerül az Audit napló oldalra API kulcs AI hozzáférése módosítva néven, és minden módosítás, amit egy AI a kulccsal végez, szintén ott jelenik meg, a kulcs nevével együtt.

Az AI hozzáféréstől függetlenül maga a kulcs továbbra is teljes hozzáférést adó titok a Yaplet API-jaihoz. Kezeld jelszóként.

Biztonság

Biztonsági ajánlott eljárások:

Tárold a kulcsokat biztonságosan (környezeti változók, titokkezelők)
Soha ne commitolj kulcsokat verziókezelőbe
Kulcscsere esetén hozz létre egy újat, állítsd át rá az integrációdat, majd töröld a régi kulcsot
Korlátozd a hozzáférést a szükséges csapattagokra