Aller au contenu

Plugins

Des extensions pour votre espace de travail et vos applications.

Ouvrir Plugins
Vérifié par rapport au tableau de bord le 18 novembre 2026

Plugins a six méthodes publiques. Elles listent les plugins et gèrent ceux qui s'exécutent avec un projet sur les serveurs de Xuda, le deuxième rail de la page Plugins. Chacune agit pour le compte dont vous utilisez la clé API.

Ajouter un plugin au serveur de l'espace de travail, en créer un, en exécuter un et configurer ses clés se font dans le tableau de bord. Ils n'ont aucune méthode publique aujourd'hui, et install_plugin refuse un plugin qui ne s'exécute que sur un serveur d'espace de travail.

Envoyez une requête à une méthode avec votre clé. Celle-ci liste les widgets de la 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},
)

Une bonne réponse a code 1. Une réponse refusée a un code négatif et dit pourquoi dans data.

Trouver des plugins

  • get_plugins liste les plugins de la Marketplace. Elle prend, en option, plugin_id (l'identifiant complet, avec son préfixe @xuda.io/) ou id (sans ce préfixe), category (un type de plugin), limit (9999 si omis) et skip pour la pagination. Vos propres plugins privés sont listés pour vous et pour personne d'autre.
  • get_plugins_categories liste les types de plugins. Elle ne prend aucun champ.
  • get_app_plugins liste les plugins installés dans une application. Elle prend app_id et un plugin_type_filter facultatif.

Installer et retirer un plugin de projet

L'installation demande d'abord d'accepter les conditions du plugin, comme le fait le tableau de bord.

  1. Appelez get_install_consent avec item_kind défini sur plugin et le plugin_name. Elle renvoie les conditions et un content_hash.
  2. Appelez install_plugin avec app_id, plugin_name et consent, un objet avec accepted, le content_hash qui vous a été donné et une locale. Sans consentement valide, l'installation est refusée et rien n'est écrit.

install_plugin prend aussi consent_source (l'écran sur lequel le consentement a été accepté, uniquement pour le journal d'audit), validate_free (quand il vaut true, un plugin payant est refusé) et version (pour une mise à jour, la version qui vous a été proposée : une version qui n'est pas la dernière est refusée).

uninstall_plugin prend app_id et plugin_name et retire le plugin de l'application. Elle ne redemande pas confirmation.

Importer un plugin privé

upload_plugin enregistre un paquet de plugin. Elle lit data.plugin_name et data.plugin_type (parmi dbs, widget, graphics, library, platform, framework, util, ui) dans le corps, avec data.package_source (npm, la valeur par défaut, ou xuda_hosted avec un data.package_url) et data.visibility. Définissez data.visibility sur private pour le garder hors de la Marketplace.

Un import privé demande l'adhésion Agence ou le forfait Plugins Pro de l'espace de travail. Mettre un plugin sur la Marketplace reste réservé à l'adhésion Agence. Vous ne pouvez mettre à jour qu'un plugin importé par votre propre compte.

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026