Plugins
Erweiterungen für deinen Workspace und deine Apps.
Plugins hat sechs öffentliche Methoden. Sie listen Plugins auf und verwalten die Plugins, die mit einem Projekt auf den Servern von Xuda laufen, die zweite Leiste der Seite Plugins. Jede handelt für das Konto, dessen API-Schlüssel du verwendest.
Ein Plugin zum Workspace-Server hinzufügen, eines erstellen, eines ausführen und seine Schlüssel einrichten geht im Dashboard. Dafür gibt es heute keine öffentliche Methode, und install_plugin lehnt ein Plugin ab, das nur auf einem Workspace-Server läuft.
Sende mit deinem Schlüssel eine Anfrage an eine Methode. Diese listet die Widgets des Marketplace auf:
Eine gute Antwort hat code 1. Eine abgelehnte hat einen negativen code und nennt den Grund in data.
Plugins finden
get_pluginslistet die Plugins im Marketplace auf. Es nimmt optionalplugin_id(die vollständige ID, mit ihrem Präfix@xuda.io/) oderid(ohne es),category(ein Plugin-Typ),limit(9999, wenn weggelassen) undskipzum Blättern. Deine eigenen privaten Plugins werden für dich aufgelistet und für niemanden sonst.get_plugins_categorieslistet die Plugin-Typen auf. Es nimmt keine Felder.get_app_pluginslistet die in einer App installierten Plugins auf. Es nimmtapp_idund ein optionalesplugin_type_filter.
Ein Projekt-Plugin installieren und entfernen
Für die Installation müssen zuerst die Bedingungen des Plugins akzeptiert werden, wie im Dashboard.
- Rufe
get_install_consentauf, mititem_kindaufplugingesetzt und demplugin_name. Es gibt die Bedingungen und einencontent_hashzurück. - Rufe
install_pluginauf, mitapp_id,plugin_nameundconsent, einem Objekt mitaccepted, demcontent_hash, den du bekommen hast, und einemlocale. Ohne eine gültige Zustimmung wird die Installation abgelehnt, und es wird nichts geschrieben.
install_plugin nimmt außerdem consent_source (auf welchem Bildschirm die Zustimmung gegeben wurde, nur für den Audit-Eintrag), validate_free (wenn true, wird ein Plugin mit einem Preis abgelehnt) und version (bei einem Update die Version, die dir angeboten wurde: Eine Version, die nicht die neueste ist, wird abgelehnt).
uninstall_plugin nimmt app_id und plugin_name und entfernt das Plugin aus der App. Es fragt nicht noch einmal.
Ein privates Plugin hochladen
upload_plugin speichert ein Plugin-Paket. Es liest data.plugin_name und data.plugin_type (eines von dbs, widget, graphics, library, platform, framework, util, ui) aus dem Body, mit data.package_source (npm, der Standard, oder xuda_hosted mit einer data.package_url) und data.visibility. Setze data.visibility auf private, um es aus dem Marketplace herauszuhalten.
Ein privater Upload braucht die Agentur-Mitgliedschaft oder den Tarif Plugins Pro des Workspace. Ein Plugin in den Marketplace zu stellen bleibt der Agentur-Mitgliedschaft vorbehalten. Du kannst nur ein Plugin aktualisieren, das dein eigenes Konto hochgeladen hat.