Ugrás a tartalomhoz

Bővítmények

Kiegészítők a munkaterületéhez és az alkalmazásaihoz.

Bővítmények megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 18.

A Pluginsnek hat nyilvános metódusa van. Bővítményeket listáznak, és kezelik azokat a bővítményeket, amelyek egy projekttel futnak a Xuda szerverein, a Plugins oldal második sínjén. Mindegyik annak a fióknak a nevében jár el, amelynek az API-kulcsát használja.

A bővítmény hozzáadása a munkaterületi szerverhez, építése, futtatása és a kulcsainak beállítása az irányítópulton történik. Ezekhez ma nincs nyilvános metódus, és az install_plugin elutasít egy olyan bővítményt, amely csak munkaterületi szerveren fut.

Küldjön kérést egy metódusnak a kulcsával. Ez a piactér widgetjeit listázza:

curl -s https://xuda.ai/cpi/get_plugins \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","category":"widget","limit":20}'
const res = await fetch('https://xuda.ai/cpi/get_plugins', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', category: 'widget', limit: 20 }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_plugins',
    json={'api_key': 'YOUR_API_KEY', 'category': 'widget', 'limit': 20},
)

A sikeres válasz code értéke 1. Az elutasított válasz code értéke negatív, és a data mezőben megmondja az okot.

Bővítmények keresése

  • A get_plugins a piactér bővítményeit listázza. Opcionális mezői: plugin_id (a teljes azonosító, az @xuda.io/ előtaggal) vagy id (előtag nélkül), category (egy bővítménytípus), limit (9999, ha kihagyja) és skip a lapozáshoz. A saját privát bővítményeit csak Ön látja a listában.
  • A get_plugins_categories a bővítménytípusokat listázza. Nem vár mezőt.
  • A get_app_plugins egy alkalmazásban telepített bővítményeket listázza. Az app_id mezőt és egy opcionális plugin_type_filter mezőt vár.

Projektbővítmény telepítése és eltávolítása

A telepítés előbb a bővítmény feltételeinek elfogadását kéri, ahogy az irányítópult is.

  1. Hívja meg a get_install_consent metódust, az item_kind értéke plugin, és adja meg a plugin_name értéket. Visszaadja a feltételeket és egy content_hash értéket.
  2. Hívja meg az install_plugin metódust az app_id, a plugin_name és a consent mezővel, amely egy objektum az accepted, a kapott content_hash és egy locale mezővel. Érvényes beleegyezés nélkül a telepítést elutasítjuk, és semmi nem íródik.

Az install_plugin fogadja még a consent_source (melyik képernyőn fogadták el a beleegyezést, csak a naplóbejegyzéshez), a validate_free (ha igaz, az árral rendelkező bővítményt elutasítjuk) és a version (frissítésnél az Önnek felajánlott verzió: a nem legutóbbi verziót elutasítjuk) mezőt.

Az uninstall_plugin az app_id és a plugin_name mezőt várja, és eltávolítja a bővítményt az alkalmazásból. Nem kérdez rá újra.

Privát bővítmény feltöltése

Az upload_plugin elment egy bővítménycsomagot. A törzsből a data.plugin_name és a data.plugin_type mezőt olvassa (értéke dbs, widget, graphics, library, platform, framework, util vagy ui), a data.package_source (npm, az alapértelmezett, vagy xuda_hosted egy data.package_url mezővel) és a data.visibility mezővel. Állítsa a data.visibility értékét private-ra, hogy kimaradjon a piactérről.

A privát feltöltéshez az Agency tagság vagy a munkaterület Plugins Pro csomagja kell. A bővítmény piactérre helyezése az Agency tagsághoz kötött marad. Csak olyan bővítményt frissíthet, amelyet a saját fiókja töltött fel.

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.