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

# Megosztott összekötők

> Egyetlen szolgáltatásfiók csatlakoztatása, amelyen az összes alkalmazásfelhasználó osztozik

Ön a fejlesztői dokumentációt nézi

Ez a dokumentáció a Base44 fejlesztői
platformmal dolgozó fejlesztőknek szól. Az alkalmazásszerkesztőben használható összekötőkről lásd:&#x20;
[Összekötők használata](https://docs.base44.com/hu/Integrations/Connectors.md).

A megosztott összekötő egyetlen fiókot csatlakoztat a teljes alkalmazáshoz. Minden alkalmazásfelhasználó ugyanazt az OAuth-tokent használja. Ezt szolgáltatásfiókokhoz használja, például egy céges Slack-csatornára való közzétételhez, egy megosztott Google-naptár olvasásához vagy egy megosztott Notion-munkaterület lekérdezéséhez.

**Megosztott összekötő beállítása:**

1. [**Konfiguráljon**](#configure) egy JSONC-fájlt minden szükséges szolgáltatáshoz
2. [**Telepítse és engedélyezze**](#deploy-and-authorize) a CLI-vel
3. [**Használja backend-függvényekben**](#use-in-backend-functions): OAuth-összekötőknél hívja meg a [`getConnection()`](https://docs.base44.com/developers/references/sdk/docs/interfaces/connectors#getconnection) metódust, fizetésekhez pedig közvetlenül a [Stripe REST API-t](#stripe) használja

## Konfigurálás

Minden összekötő egy JSONC-fájl a projekt connectors könyvtárában. A fájl meghatározza az integráció típusát és az alkalmazáshoz szükséges hatóköröket. Alapértelmezés szerint ez a `base44/connectors/` könyvtár, de az útvonalat a [projektkonfigurációban](https://docs.base44.com/hu/developers/backend/overview/project-structure.md#config-jsonc) módosíthatja.

**connectors**

**googlecalendar.jsonc**

**slack.jsonc**

**slackbot.jsonc**

**notion.jsonc**

### Példa

Ez a példa egy Google Calendar-összekötőt konfigurál olvasási és eseménykezelési hatókörökkel:

```jsonc theme={null}
{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events",
  ],
}
```

### Mezőreferencia

**type** `string` *required*

Az integráció típusazonosítója. Az elfogadott értékek teljes listáját a [támogatott szolgáltatások](https://docs.base44.com/hu/developers/backend/resources/connectors.md#supported-services) táblázatában találja.

Minden összekötőtípus csak egyszer definiálható a projektben.

**scopes** `array` *required*

Az integrációhoz szükséges OAuth-hatókörök tömbje. A konkrét hatókörök
a külső szolgáltatástól és az alkalmazás által végzett műveletektől függenek.
Az egyes szolgáltatások elérhető hatóköreit az [összekötők engedélyei és
hatókörei](https://docs.base44.com/hu/Integrations/connectors-catalog) dokumentációban
találja.

## Telepítés és engedélyezés

Az összekötőket a [`connectors push`](https://docs.base44.com/developers/references/cli/commands/connectors-push) vagy a [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) paranccsal telepítheti. A meglévő összekötők Base44-ből való letöltéséhez használja a [`connectors pull`](https://docs.base44.com/developers/references/cli/commands/connectors-pull) parancsot.

Feltöltéskor a CLI az összekötő típusától függően kezeli az egyes összekötőket:

* **OAuth-összekötők:** A CLI egyenként kéri az egyes összekötők engedélyezését. Felajánlja a böngésző automatikus megnyitását, és ha elfogadja, sorban végigmegy az egyes integrációk engedélyezési oldalain. Az engedélyezés után az OAuth-tokenek biztonságosan tárolódnak, és az SDK-val lekérheti őket.
* **Stripe:** A CLI Stripe-sandboxot hoz létre az alkalmazáshoz, és egy igénylési URL-t ad vissza a bevezetés befejezéséhez. Nincs szükség OAuth-folyamatra.

### Összekötő beállítása helyi projekt nélkül

A `connectors push` a projektből olvassa az összekötőfájlokat, ezért helyi checkoutra van szüksége. Ha helyi projekt nélkül szeretne összekötőt beállítani, például egy alkalmazásszerkesztőben épített alkalmazáson vagy egy MI-ügynökből, használja a [`connectors initiate`](https://docs.base44.com/developers/references/cli/commands/connectors-initiate) parancsot. Ez közvetlenül egy [célalkalmazáson](https://docs.base44.com/developers/references/cli/commands/introduction.md#select-a-target-app) állít be egy összekötőt, és elindítja annak OAuth-folyamatát, fájlok olvasása vagy írása nélkül. Ha utána az összekötő konfigurációját egy helyi projektbe szeretné hozni, futtassa a [`connectors pull`](https://docs.base44.com/developers/references/cli/commands/connectors-pull) parancsot.

> [!NOTE]
>
> A `connectors initiate` egyetlen összekötőt állít be, és soha nem távolít el egyet sem. A `connectors push` hozzáadja és frissíti a helyi fájlokban szereplő összekötőket, a `--force` kapcsolóval pedig a fájlokból hiányzó összekötőket is eltávolítja.

## Használat backend-függvényekben

A telepítés és engedélyezés után használja az összekötőt a [backend-függvényekben](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md). A megközelítés az összekötő hitelesítési modelljétől függ:

> [tab] OAuth-összekötők
>
> Hívja meg a [`connectors.getConnection()`](https://docs.base44.com/developers/references/sdk/docs/interfaces/connectors#getconnection) metódust az összekötő típusával, hogy egy `accessToken` értéket kapjon a hitelesített API-hívásokhoz. Egyes összekötők egy `connectionConfig` objektumot is visszaadnak további paraméterekkel (például aldomain vagy fiókazonosító).
>
> Ez a példa lekér egy Google Calendar-kapcsolatot, és lekérdezi a közelgő eseményeket:
>
> ```typescript theme={null}
> const { accessToken } =
>   await base44.asServiceRole.connectors.getConnection("googlecalendar");
>
> const timeMin = new Date().toISOString();
> const url = `https://www.googleapis.com/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=${timeMin}`;
>
> const response = await fetch(url, {
>   headers: { Authorization: `Bearer ${accessToken}` },
> });
>
> const events = await response.json();
> ```

> [tab] Stripe
>
> A Stripe nem használja a `getConnection()` metódust. Ehelyett a platform az összekötő létrehozásakor alkalmazásszintű titkos adatként tárolja a Stripe API-kulcsokat. A backend-függvényekben olvassa ki a `STRIPE_SECRET_KEY` értéket a `secrets.get()` segítségével, és hívja közvetlenül a [Stripe REST API-t](https://docs.stripe.com/api).
>
> Ez a példa egy Stripe Checkout munkamenetet hoz létre, és visszaadja a fizetési URL-t:
>
> ```typescript theme={null}
> import { secrets } from "base44:runtime";
>
> Deno.serve(async (req) => {
>   const STRIPE_SECRET_KEY = secrets.get("STRIPE_SECRET_KEY");
>   const { priceId, successUrl, cancelUrl } = await req.json();
>
>   const response = await fetch("https://api.stripe.com/v1/checkout/sessions", {
>     method: "POST",
>     headers: {
>       Authorization: `Bearer ${STRIPE_SECRET_KEY}`,
>       "Content-Type": "application/x-www-form-urlencoded",
>     },
>     body: new URLSearchParams({
>       "payment_method_types[]": "card",
>       "line_items[0][price]": priceId,
>       "line_items[0][quantity]": "1",
>       mode: "payment",
>       success_url: successUrl || `${req.headers.get("origin")}?success=true`,
>       cancel_url: cancelUrl || `${req.headers.get("origin")}?canceled=true`,
>     }),
>   });
>
>   const session = await response.json();
>   return Response.json({ url: session.url });
> });
> ```

## Összekötő-munkafolyamatok

Az összekötő-munkafolyamatokkal a backend-függvények valós időben reagálhatnak a csatlakoztatott eszközök eseményeire. Futtathat például egy függvényt, amikor új e-mail érkezik a Gmailbe, vagy egy fájl módosul a Google Drive-on. Lásd: [Connector](https://docs.base44.com/hu/Building-your-app/Creating-workflows.md#connector) eseményindítók.

## Lásd még

* [Az összekötők áttekintése](https://docs.base44.com/hu/developers/backend/resources/connectors.md)
* [Alkalmazásfelhasználói összekötők](https://docs.base44.com/hu/developers/backend/resources/connectors/app-user-connectors.md)
* [SDK connectors referencia](https://docs.base44.com/developers/references/sdk/docs/interfaces/connectors.md#getconnection)
* [connectors push](https://docs.base44.com/developers/references/cli/commands/connectors-push.md)
* [connectors pull](https://docs.base44.com/developers/references/cli/commands/connectors-pull.md)
* [connectors initiate](https://docs.base44.com/developers/references/cli/commands/connectors-initiate.md)
* [deploy](https://docs.base44.com/developers/references/cli/commands/deploy.md)
* [Backend-függvények](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md)
* [Munkafolyamatok létrehozása](https://docs.base44.com/hu/Building-your-app/Creating-workflows.md)

> [!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.