Vai al contenuto

Plugins

Componenti aggiuntivi per il tuo workspace e le tue app.

Apri Plugins
Verificato rispetto alla dashboard il 18 novembre 2026

I plugin hanno sei metodi pubblici. Elencano i plugin e gestiscono quelli che girano con un progetto sui server di Xuda, la seconda barra della pagina Plugin. Ognuno agisce per il conto di cui usi la chiave API.

Aggiungere un plugin al server del workspace, crearne uno, eseguirlo e configurare le sue chiavi si fa nella dashboard. Oggi non hanno un metodo pubblico, e install_plugin rifiuta un plugin che gira solo su un server del workspace.

Invia una richiesta a un metodo con la tua chiave. Questa elenca i widget del 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},
)

Una risposta riuscita ha code 1. Una rifiutata ha un code negativo e ne spiega il motivo in data.

Trova i plugin

  • get_plugins elenca i plugin nel Marketplace. Accetta i campi facoltativi plugin_id (l'id completo, con il prefisso @xuda.io/) o id (senza), category (un tipo di plugin), limit (9999 se omesso) e skip per la paginazione. I tuoi plugin privati sono elencati per te e per nessun altro.
  • get_plugins_categories elenca i tipi di plugin. Non accetta campi.
  • get_app_plugins elenca i plugin installati in un'app. Accetta app_id e un plugin_type_filter facoltativo.

Installa e rimuovi un plugin di progetto

L'installazione richiede prima l'accettazione dei termini del plugin, come fa la dashboard.

  1. Chiama get_install_consent con item_kind impostato su plugin e il plugin_name. Restituisce i termini e un content_hash.
  2. Chiama install_plugin con app_id, plugin_name e consent, un oggetto con accepted, il content_hash che ti è stato dato e un locale. Senza un consenso valido l'installazione viene rifiutata e non viene scritto nulla.

install_plugin accetta anche consent_source (su quale schermata è stato accettato il consenso, solo per il registro di controllo), validate_free (se vero, un plugin con un prezzo viene rifiutato) e version (per un aggiornamento, la versione che ti è stata offerta: una versione che non è l'ultima viene rifiutata).

uninstall_plugin accetta app_id e plugin_name e rimuove il plugin dall'app. Non chiede di nuovo conferma.

Carica un plugin privato

upload_plugin salva un pacchetto di plugin. Legge data.plugin_name e data.plugin_type (uno tra dbs, widget, graphics, library, platform, framework, util, ui) dal corpo, con data.package_source (npm, il valore predefinito, oppure xuda_hosted con un data.package_url) e data.visibility. Imposta data.visibility su private per tenerlo fuori dal Marketplace.

Un caricamento privato richiede l'abbonamento Agenzia o il piano Plugins Pro del workspace. Mettere un plugin nel Marketplace resta riservato all'abbonamento Agenzia. Puoi aggiornare solo un plugin caricato dal tuo stesso conto.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026