Przejdź do treści

Wtyczki

Dodatki do Twojej przestrzeni roboczej i aplikacji.

Otwórz Wtyczki
Sprawdzono z pulpitem dnia 18 listopada 2026

Wtyczki mają sześć metod publicznych. Wyświetlają listę wtyczek i zarządzają wtyczkami, które działają z projektem na serwerach Xuda, czyli drugą szyną strony Wtyczek. Każda działa w imieniu konta, którego klucza API używasz.

Dodawanie wtyczki do serwera przestrzeni roboczej, tworzenie jej, uruchamianie i konfigurowanie jej kluczy odbywają się w dashboardzie. Nie mają dziś metody publicznej, a install_plugin odrzuca wtyczkę, która działa tylko na serwerze przestrzeni roboczej.

Wyślij żądanie do metody ze swoim kluczem. To wyświetla widżety z Marketplace:

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

Poprawna odpowiedź ma code 1. Odrzucona ma ujemny code i w data mówi dlaczego.

Znajdź wtyczki

  • get_plugins wyświetla wtyczki z Marketplace. Przyjmuje opcjonalne plugin_id (pełny identyfikator z prefiksem @xuda.io/) lub id (bez niego), category (typ wtyczki), limit (9999, jeśli pominięty) i skip do stronicowania. Twoje własne prywatne wtyczki są na liście dla Ciebie i dla nikogo innego.
  • get_plugins_categories wyświetla typy wtyczek. Nie przyjmuje żadnych pól.
  • get_app_plugins wyświetla wtyczki zainstalowane w aplikacji. Przyjmuje app_id i opcjonalne plugin_type_filter.

Zainstaluj i usuń wtyczkę projektu

Instalacja wymaga najpierw zaakceptowania warunków wtyczki, tak jak w dashboardzie.

  1. Wywołaj get_install_consent z item_kind ustawionym na plugin i z plugin_name. Zwraca warunki i content_hash.
  2. Wywołaj install_plugin z app_id, plugin_name i consent, czyli obiektem z accepted, otrzymanym content_hash i locale. Bez ważnej zgody instalacja jest odrzucana i nic nie jest zapisywane.

install_plugin przyjmuje też consent_source (na którym ekranie zaakceptowano zgodę, tylko do zapisu audytowego), validate_free (gdy true, wtyczka z ceną jest odrzucana) i version (przy aktualizacji wersja, którą ci zaoferowano: wersja, która nie jest najnowsza, jest odrzucana).

uninstall_plugin przyjmuje app_id i plugin_name i usuwa wtyczkę z aplikacji. Nie pyta ponownie.

Wgraj prywatną wtyczkę

upload_plugin zapisuje pakiet wtyczki. Odczytuje z treści data.plugin_name i data.plugin_type (jedno z dbs, widget, graphics, library, platform, framework, util, ui), z data.package_source (npm, domyślnie, albo xuda_hosted z data.package_url) i data.visibility. Ustaw data.visibility na private, aby nie trafiła do Marketplace.

Prywatne wgranie wymaga członkostwa Agency lub planu Plugins Pro przestrzeni roboczej. Umieszczenie wtyczki w Marketplace pozostaje przy członkostwie Agency. Możesz aktualizować tylko wtyczkę, którą wgrało Twoje własne konto.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026