> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Egyéni integrációk kezelése és használata

> Adjon hozzá egy megosztott API-t a munkaterülethez egy OpenAPI-specifikációból, válassza ki az elérhetővé tett végpontokat, és engedje, hogy minden alkalmazás hívhassa. Tekintse meg, szerkessze vagy törölje a munkaterületi integrációkat.

A munkaterületi integrációkkal megosztott külső API-kat regisztrálhat munkaterületi szinten egy OpenAPI-specifikációból. A specifikációt URL-ről vagy beillesztett JSON-ként importálja, legfeljebb 30 műveletet választ ki, és egyszer csatlakoztatja az API-t a munkaterületen. Ezután a munkaterület bármely alkalmazása meghívhatja ezeket a jóváhagyott műveleteket a `base44.integrations.custom.call()` segítségével, ahelyett hogy saját kapcsolatot állítana be. Ez a belső API-khoz és a csapata által használt partner-API-khoz egyaránt működik.

Ezek az integrációk biztonságosra és megbízhatóra vannak tervezve. Minden fejlécérték titkosított munkaterületi titkos adatként tárolódik, a bizalmas hitelesítési fejlécértékek pedig mentés után soha többé nem jelennek meg. Futásidőben a hívások szerveroldalon, a szerveroldali kéréshamisítás (SSRF) elleni védelemmel futnak, és a munkaterületi fejlécek elsőbbséget élveznek, így az alkalmazások nem írhatják felül őket. Ha a fejlécek betöltése sikertelen, a mentés le van tiltva, így véletlenül sem vesznek el.

![A munkaterület-beállítások Custom integrations oldala egy integrációval](https://mintcdn.com/base44/G_oNLsUyqxpQ5Qq5/images/intgs.png?fit=max\&auto=format\&n=G_oNLsUyqxpQ5Qq5\&q=85\&s=e7f68f4b506ab3bfe560bc59eff67efa)

Integrációk egy Base44-munkaterületen

> [!WARNING]
>
> **Ki hozhat létre és használhat munkaterületi integrációkat:**
>
> * **Csomag:** Munkaterületi integrációk létrehozásához, szerkesztéséhez vagy törléséhez [Builder csomag](https://base44.com/pricing) vagy magasabb szükséges.
> * **Szerepkör:** Csak a munkaterület tulajdonosai és adminisztrátorai hozhatnak létre, szerkeszthetnek vagy törölhetnek munkaterületi integrációkat.
> * **Használat:** A munkaterületen bárki használhat egy meglévő munkaterületi integrációt az alkalmazásaiban, akár Free csomaggal is.

***

## A munkaterületi integrációk megértése

A munkaterületi integráció a munkaterület megosztott kapcsolata egy külső vagy belső API-hoz, például egy CRM-hez, ügyfélszolgálati rendszerhez vagy egyéni backendhez. Egyszer definiálja a munkaterületen egy OpenAPI- vagy Swagger-specifikációból, kiválasztja, mely műveletek engedélyezettek, és a munkaterület bármely kompatibilis alkalmazása meghívhatja ezeket a műveleteket. Így a konfiguráció egy helyen marad, és könnyebb kezelni a csapata által használt külső rendszereket.

**A munkaterületi integrációk akkor hasznosak, ha:**

* Ugyanazt a külső vagy belső API-t szeretné használni a munkaterület több alkalmazásában.
* A bizalmas adatokat, például az API-kulcsokat és tokeneket egy biztonságos helyen, munkaterületi titkos adatként szeretné kezelni.
* Korlátozni szeretné az elérhető végpontokat, hogy az alkalmazások csak jóváhagyott, a specifikációban definiált műveleteket hívjanak.
* Egyértelműen el szeretné különíteni őket az egykattintásos OAuth-összekötőktől, mivel a munkaterületi integrációkat a munkaterület kezeli, és specifikáció alapján működnek.
* Átláthatóvá szeretné tenni, mely külső rendszerekre támaszkodik a munkaterülete.

***

## Integráció létrehozása

Hozzon létre egyéni munkaterületi integrációt, ha egy új külső API-t szeretne elérhetővé tenni az alkalmazásai számára, és az API rendelkezik OpenAPI- vagy Swagger-specifikációval. A Base44 beolvassa a specifikációt, lehetővé teszi az elérhetővé tenni kívánt végpontok kiválasztását, és újrahasználható integrációt hoz létre a munkaterülethez.

> [!TIP]
>
> **Mielőtt elkezdené:** Győződjön meg róla, hogy rendelkezik érvényes OpenAPI- vagy Swagger-specifikációval a használni kívánt API-hoz, akár JSON- vagy YAML-fájlként egy nyilvános URL-en, akár kimásolható JSON-ként.

### lépés | Új integráció hozzáadása

1. Kattintson a fiókja bal alsó sarkában a munkaterület nevére.
2. Kattintson a **Beállítások** elemre.
3. Az **Építőeszközök** alatt kattintson az **Egyéni integrációk** elemre.
4. Kattintson az **Integráció hozzáadása** gombra. Ha még nincs integrációja, kattintson az **Integráció létrehozása** gombra.
5. Válassza ki, hogyan adja meg az API-specifikációt:
   * **URL-ből:** Az **OpenAPI-specifikáció URL-je** mezőben adja meg az OpenAPI- vagy Swagger-JSON- vagy -YAML-fájl nyilvános URL-jét, például `https://api.example.com/openapi.json`.
   * **JSON beillesztése:** Illessze be a szerkesztőbe az OpenAPI- vagy Swagger-specifikáció teljes JSON-definícióját.
6. Kattintson a **Tovább** gombra.

![Az Add custom integration párbeszédablak 1. lépése egy megadott OpenAPI-specifikációs URL-lel](https://mintcdn.com/base44/dZzytOu9j0oe_U9j/images/step1again.png?fit=max\&auto=format\&n=dZzytOu9j0oe_U9j\&q=85\&s=998a5ac6f68d97d2a6e7883276070548)

1. lépés: a forrás hozzáadása

### lépés | Az elérhetővé tett végpontok kiválasztása

Válasszon ki legfeljebb 30 végpontot az integrációhoz.

**A végpontok kiválasztása:**

1. Tekintse át a Base44 által a specifikációban talált végpontok listáját. A keresőmezővel metódus vagy útvonalnév szerint kereshet konkrét útvonalakat vagy műveleteket.
2. Jelölje be a munkaterület számára elérhetővé tenni kívánt végpontok jelölőnégyzetét.
3. Kattintson a **Tovább** gombra.

![A munkaterületi integráció számára elérhetővé tett végpontok kiválasztása](https://mintcdn.com/base44/dZzytOu9j0oe_U9j/images/step2.png?fit=max\&auto=format\&n=dZzytOu9j0oe_U9j\&q=85\&s=2c9e579cce16c3c548443170416c9fc3)

2. lépés: a végpontok kiválasztása

### lépés | Az integráció konfigurálása

Konfigurálja az integráció adatait, állítsa be az alap-URL-t, és adja hozzá az API által igényelt egyéni fejléceket. Minden fejlécérték titkosított munkaterületi titkos adatként tárolódik.

Az `authorization`, `x-api-key`, `api-key`, `api_key`, `apikey`, `x-auth-token`, `x-access-token`, `x-token`, `x-secret-key`, `x-api-secret`, `bearer`, `secret`, `password` vagy `credential` nevű fejlécek bármilyen kis- és nagybetűs írásmóddal bizalmasnak számítanak. Értékük mentés után soha többé nem jelenik meg, így az integráció későbbi szerkesztésekor „(sensitive - delete to change)” felirattal látszanak. A módosításhoz törölje a fejlécet, és adja hozzá újra.

**Az integráció konfigurálása:**

1. Adja meg az integráció adatait:
   * **Slug:** Adjon meg egy URL-barát azonosítót az integrációhoz, például `my-api`.
   * **Név:** Adja meg a munkaterület integrációs listájában megjelenő nevet.
   * **Leírás:** Írja le, mit csinál az integráció, hogy a csapattársak tudják, mikor használják.
   * **Alap-URL:** Erősítse meg vagy frissítse az API alap-URL-jét.
2. Ha az API minden kérésnél elküldendő fejléceket igényel, adja hozzá őket az **Egyéni fejlécek** részben:
   1. Kattintson a **Fejléc hozzáadása** gombra.
   2. Adja meg a fejléc nevét, például `Authorization` vagy `X-API-Key`.
   3. Adja meg a fejléc értékét, például az API-kulcsot vagy a tokent.
   4. A láthatóság ikonnal szükség szerint elrejtheti vagy megjelenítheti a fejléc értékét.
3. Tekintse át a kiválasztott végpontok listáját a párbeszédablak alján.
4. Kattintson az **Integráció létrehozása** gombra.

![Az Add custom integration párbeszédablak Configure lépése az alap-URL mezővel, alatta egyéni fejlécsorokkal, amelyek közül az egyik bizalmasként maszkolt, és egy listázott POST végponttal](https://mintcdn.com/base44/vGj5ZIaYUxXljz-f/images/configure.png?fit=max\&auto=format\&n=vGj5ZIaYUxXljz-f\&q=85\&s=56883c536d3042bc22ba14c5043ab207)

A munkaterületi integráció konfigurálása

***

## A munkaterületi integrációk kezelése

A munkaterületi integráció létrehozása után az a munkaterület-beállítások **Egyéni integrációk** oldalán jelenik meg. Innen megtekintheti a részleteit, szerkesztheti a beállításait, vagy eltávolíthatja, ha már nincs rá szüksége.

### Az integráció részleteinek megtekintése

Nézze meg, mely végpontokat teszi elérhetővé egy integráció.

**Az integráció részleteinek megtekintése:**

1. Kattintson a fiókja bal alsó sarkában a munkaterület nevére.
2. Kattintson a **Beállítások** elemre.
3. Az **Építőeszközök** alatt kattintson az **Egyéni integrációk** elemre.
4. Kattintson az integráció kártyáján a végpontok számára, például **3 végpont**, hogy lássa az elérhetővé tett végpontokat.

### Integráció szerkesztése

Módosíthatja az integráció adatait, slugját, alap-URL-jét, végpontjait és fejléceit. Az integráció az először importált specifikációt őrzi meg, így egy újabb verzió használatához hozzon létre új integrációt (lásd a lépések utáni tippet).

**Integráció szerkesztése:**

1. Kattintson a fiókja bal alsó sarkában a munkaterület nevére.
2. Kattintson a **Beállítások** elemre.
3. Az **Építőeszközök** alatt kattintson az **Egyéni integrációk** elemre.
4. Kattintson az integráció kártyáján a **További műveletek** ikonra .
5. Kattintson a **Szerkesztés** lehetőségre.
6. Frissítse a módosítani kívánt mezőket.
7. Kattintson a **Mentés** gombra.

![Egy egyéni integráció More actions menüje kiemelt Edit lehetőséggel](https://mintcdn.com/base44/G_oNLsUyqxpQ5Qq5/images/editint.png?fit=max\&auto=format\&n=G_oNLsUyqxpQ5Qq5\&q=85\&s=1da5227d2224df12fd20c60419ba6079)

Munkaterületi integráció szerkesztése

> [!TIP]
>
> **A specifikáció újabb verziójának használata:** Az alkalmazások a slugja alapján hívják az integrációt, ezért az új integrációnak ugyanazzal a sluggal kell rendelkeznie. Szerkessze a régi integrációt, és módosítsa a slugját, hozza létre az új integrációt a frissített specifikációból az eredeti sluggal, majd törölje a régit.

### Integráció törlése

Töröljön egy integrációt, ha a munkaterület egyetlen alkalmazásának sincs rá szüksége.

**Integráció törlése:**

1. Kattintson a fiókja bal alsó sarkában a munkaterület nevére.
2. Kattintson a **Beállítások** elemre.
3. Az **Építőeszközök** alatt kattintson az **Egyéni integrációk** elemre.
4. Kattintson az integráció kártyáján a **További műveletek** ikonra .
5. Kattintson a **Törlés** lehetőségre.
6. Kattintson ismét a **Törlés** gombra annak megerősítéséhez, hogy eltávolítja a munkaterületről.

![Egy egyéni integráció More actions menüje kiemelt Delete lehetőséggel](https://mintcdn.com/base44/G_oNLsUyqxpQ5Qq5/images/deleteint.png?fit=max\&auto=format\&n=G_oNLsUyqxpQ5Qq5\&q=85\&s=4d2342267e44c07f8fc790d56014ff58)

Munkaterületi integráció törlése

> [!WARNING]
>
> Egy munkaterületi integráció törlése tönkreteheti az attól függő alkalmazásszintű integrációkat. Egy megosztott integráció eltávolítása előtt ellenőrizze az aktív alkalmazásokat.

***

## GYIK

Kattintson az alábbi kérdésekre, hogy többet megtudjon a munkaterületi integrációkról.

> [accordion] Hogyan használhatok munkaterületi integrációt az alkalmazásomban?
>
> A munkaterületi integráció létrehozása után az MI-csevegés a munkaterület bármely új vagy meglévő alkalmazásában használhatja. Nevezze meg a szolgáltatást a promptban, és az MI-csevegés kiválasztás nélkül a megfelelő integrációt használja. Ha például a munkaterületen van GitHub API-integráció:
>
> ```text theme={null}
> Hozzon létre egy oldalt, amely listázza a nyitott GitHub-issue-imat, és lehetővé teszi a címke szerinti szűrést.
> ```

> [accordion] Ki hozhat létre és kezelhet munkaterületi integrációkat?
>
> Munkaterületi integrációk létrehozásához vagy kezeléséhez a munkaterület tulajdonosának vagy adminisztrátorának kell lennie, Builder vagy magasabb csomaggal, és hozzáféréssel a munkaterület-beállítások **Egyéni integrációk** oldalához. Ha nem látja az **Integráció hozzáadása** gombot vagy a szerkesztési lehetőségeket, forduljon a munkaterület adminisztrátorához, és kérje meg, hogy módosítsa a szerepkörét, vagy hozza létre Ön helyett az integrációt.

> [accordion] Mi történik, ha megváltozik az OpenAPI-specifikáció?
>
> A Base44 az integráció létrehozásakor beolvasott specifikációs másolatot őrzi meg, és az integráció szerkesztése is ezt a másolatot használja, akkor is, ha az URL-en lévő specifikáció azóta megváltozott. A módosított specifikáció átvételéhez hozzon létre új integrációt a frissített specifikációból ugyanazzal a sluggal, az [Integráció szerkesztése](#editing-an-integration) részben leírtak szerint.

> [accordion] Biztonságosan tárolódnak a fejlécértékek, és ki láthatja őket?
>
> Csak a munkaterület tulajdonosai és adminisztrátorai nyithatnak meg szerkesztésre egy integrációt, és ők látják a szokásos fejlécértékeket, hogy módosíthassák őket. Egy bizalmas fejléc értékét mentés után senki, az adminisztrátorokat is beleértve, nem láthatja. A fejlécértékek alapértelmezés szerint rejtve vannak a képernyőn. Egy érték megjelenítéséhez kattintson a mellette lévő láthatóság ikonra, elrejtéséhez kattintson rá újra.

> [accordion] Lehet több munkaterületi integrációm ugyanahhoz az API-hoz?
>
> Igen. Több munkaterületi integrációt is létrehozhat, amelyek ugyanarra a külső API-ra mutatnak. Létrehozhat például külön integrációt a tesztkörnyezethez és az éles környezethez, vagy különböző alkalmazások által használt különböző végpontkészletekhez.

> [accordion] Hogyan cseréljem le a munkaterületi integráció által használt API-kulcsokat vagy más titkos adatokat?
>
> Kulcs vagy token cseréjekor először hozza létre az új hitelesítő adatot a külső rendszerben. Ezután szerkessze a munkaterületi integrációt, és frissítse a fejlécet az új kulccsal vagy tokennel. Bizalmas fejléc, például `authorization` esetén törölje a fejlécet, és adja hozzá újra az új értékkel. A módosítások mentése után az integrációt használó alkalmazások automatikusan az új értéket küldik.

> [accordion] Mi a teendő, ha az OpenAPI-specifikáció feldolgozási hibát ad?
>
> Ellenőrizze, hogy az URL közvetlenül egy érvényes OpenAPI- vagy Swagger-JSON- vagy -YAML-fájlra mutat-e. A Base44 a saját szervereiről tölti le a fájlt, így az URL-nek nyilvánosan elérhetőnek kell lennie az interneten. Nem olvasható be az a fájl, amely bejelentkezés mögött van, HTML-oldalként jelenik meg, privát hálózati címen, például `localhost` címen található, vagy átirányítás mögött van. Azt a végleges URL-t használja, ahonnan a fájl kiszolgálásra kerül.
>
> Ha továbbra is hibát lát, váltson a Paste JSON lehetőségre, másolja ki a specifikáció nyers JSON-ját, és próbálja újra.
>
> Gyors teszthez kipróbálhat egy ismerten érvényes specifikációt is, például egy nyilvános minta-API-t, hogy ellenőrizze, működik-e a folyamat.

> [!NOTE]
>
> Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az [angol nyelvű változatot](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.