Přeskočit na obsah

Pluginy

Doplňky pro váš pracovní prostor a aplikace.

Otevřít Pluginy
Ověřeno podle nástěnky dne 18. listopadu 2026

Plugins má šest veřejných metod. Vypisují pluginy a spravují pluginy, které běží s projektem na serverech Xuda, druhou lištu stránky Pluginů. Každá jedná za účet, jehož klíč API použijete.

Přidání pluginu na server pracovního prostoru, jeho vytvoření, spuštění a nastavení jeho klíčů se dělají v dashboardu. Dnes pro ně neexistuje veřejná metoda a install_plugin odmítne plugin, který běží jen na serveru pracovního prostoru.

Pošlete požadavek na metodu se svým klíčem. Tento vypíše widgety tržiště:

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},
)

Úspěšná odpověď má code 1. Odmítnutá má záporný code a v data říká proč.

Najděte pluginy

  • get_plugins vypíše pluginy v tržišti. Bere volitelné plugin_id (plné id s předponou @xuda.io/) nebo id (bez ní), category (typ pluginu), limit (9999, když ho vynecháte) a skip pro stránkování. Vaše vlastní soukromé pluginy se vypisují vám a nikomu jinému.
  • get_plugins_categories vypíše typy pluginů. Nebere žádná pole.
  • get_app_plugins vypíše pluginy nainstalované v aplikaci. Bere app_id a volitelné plugin_type_filter.

Instalujte a odeberte plugin projektu

Instalace nejdřív žádá o souhlas s podmínkami pluginu, jako to dělá dashboard.

  1. Zavolejte get_install_consent s item_kind nastaveným na plugin a plugin_name. Vrátí podmínky a content_hash.
  2. Zavolejte install_plugin s app_id, plugin_name a consent, objektem s accepted, content_hash, který jste dostali, a locale. Bez platného souhlasu je instalace odmítnuta a nic se nezapíše.

install_plugin bere také consent_source (na které obrazovce byl souhlas přijat, jen pro záznam auditu), validate_free (když je true, plugin s cenou je odmítnut) a version (pro aktualizaci verze, kterou vám nabídli: verze, která není nejnovější, je odmítnuta).

uninstall_plugin bere app_id a plugin_name a odebere plugin z aplikace. Znovu se nezeptá.

Nahrajte soukromý plugin

upload_plugin uloží balíček pluginu. Z těla čte data.plugin_name a data.plugin_type (jedno z dbs, widget, graphics, library, platform, framework, util, ui), s data.package_source (npm, výchozí, nebo xuda_hosted s data.package_url) a data.visibility. Nastavte data.visibility na private, aby zůstal mimo tržiště.

Soukromé nahrání vyžaduje členství Agency nebo tarif Plugins Pro pracovního prostoru. Umístění pluginu do tržiště zůstává členství Agency. Aktualizovat můžete jen plugin, který nahrál váš vlastní účet.

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026