Plug-ins
Add-ons voor je werkruimte en je apps.
Plugins heeft zes openbare methoden. Ze tonen plugins en beheren de plugins die met een project op de servers van Xuda draaien, de tweede balk van de pagina Plugins. Elk handelt voor het account van de API-sleutel die je gebruikt.
Een plugin toevoegen aan de werkruimteserver, er een bouwen, er een uitvoeren en zijn sleutels instellen doe je in het dashboard. Daarvoor is er vandaag geen openbare methode, en install_plugin weigert een plugin die alleen op een werkruimteserver draait.
Stuur een aanvraag naar een methode met je sleutel. Deze toont de widgets van de marketplace:
Een goed antwoord heeft code 1. Een geweigerd antwoord heeft een negatieve code en zegt in data waarom.
Plugins zoeken
get_pluginstoont de plugins in de marketplace. Het neemt optioneelplugin_id(de volledige id, met zijn voorvoegsel@xuda.io/) ofid(zonder),category(een plugintype),limit(9999 als je het weglaat) enskipvoor paginering. Je eigen privéplugins worden voor jou getoond en voor niemand anders.get_plugins_categoriestoont de plugintypen. Het neemt geen velden.get_app_pluginstoont de plugins die in een app zijn geïnstalleerd. Het neemtapp_iden een optioneleplugin_type_filter.
Een projectplugin installeren en verwijderen
Installeren vraagt eerst om akkoord met de voorwaarden van de plugin, zoals het dashboard doet.
- Roep
get_install_consentaan metitem_kindingesteld oppluginen deplugin_name. Het geeft de voorwaarden en eencontent_hashterug. - Roep
install_pluginaan metapp_id,plugin_nameenconsent, een object metaccepted, decontent_hashdie je kreeg en eenlocale. Zonder geldige toestemming wordt de installatie geweigerd en wordt er niets geschreven.
install_plugin neemt ook consent_source (op welk scherm de toestemming is gegeven, alleen voor het auditverslag), validate_free (als dit waar is, wordt een plugin met een prijs geweigerd) en version (voor een update, de versie die je werd aangeboden: een versie die niet de nieuwste is, wordt geweigerd).
uninstall_plugin neemt app_id en plugin_name en verwijdert de plugin uit de app. Het vraagt niet opnieuw.
Een privéplugin uploaden
upload_plugin slaat een pluginpakket op. Het leest data.plugin_name en data.plugin_type (een van dbs, widget, graphics, library, platform, framework, util, ui) uit de body, met data.package_source (npm, de standaard, of xuda_hosted met een data.package_url) en data.visibility. Stel data.visibility in op private om hem buiten de marketplace te houden.
Een privé-upload vraagt het Agency-lidmaatschap of het abonnement Plugins Pro van de werkruimte. Een plugin in de marketplace zetten blijft bij het Agency-lidmaatschap. Je kunt alleen een plugin bijwerken die je eigen account heeft geüpload.