Plugins
Des extensions pour votre espace de travail et vos applications.
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 :
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_pluginsliste les plugins de la Marketplace. Elle prend, en option,plugin_id(l'identifiant complet, avec son préfixe@xuda.io/) ouid(sans ce préfixe),category(un type de plugin),limit(9999 si omis) etskippour la pagination. Vos propres plugins privés sont listés pour vous et pour personne d'autre.get_plugins_categoriesliste les types de plugins. Elle ne prend aucun champ.get_app_pluginsliste les plugins installés dans une application. Elle prendapp_idet unplugin_type_filterfacultatif.
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.
- Appelez
get_install_consentavecitem_kinddéfini surpluginet leplugin_name. Elle renvoie les conditions et uncontent_hash. - Appelez
install_pluginavecapp_id,plugin_nameetconsent, un objet avecaccepted, lecontent_hashqui vous a été donné et unelocale. 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.