Plugins
Extensões para o seu espaço de trabalho e as suas apps.
Os Plugins têm seis métodos públicos. Listam plugins e gerem os plugins que correm com um projeto nos servidores da Xuda, a segunda barra da página Plugins. Cada um atua em nome da conta cuja chave de API usa.
Adicionar um plugin ao servidor do espaço de trabalho, criar um, executar um e configurar as suas chaves faz-se no dashboard. Não têm hoje método público, e install_plugin recusa um plugin que só corre num servidor de espaço de trabalho.
Envie um pedido a um método com a sua chave. Este lista os widgets do marketplace:
Uma boa resposta tem code 1. Uma recusada tem um code negativo e diz porquê em data.
Encontrar plugins
get_pluginslista os plugins do marketplace. Recebeplugin_idopcional (o id completo, com o seu prefixo@xuda.io/) ouid(sem ele),category(um tipo de plugin),limit(9999 se omitido) eskippara paginação. Os seus plugins privados são listados para si e para mais ninguém.get_plugins_categorieslista os tipos de plugin. Não recebe campos.get_app_pluginslista os plugins instalados numa app. Recebeapp_ide umplugin_type_filteropcional.
Instalar e remover um plugin de projeto
Instalar pede primeiro que os termos do plugin sejam aceites, como faz o dashboard.
- Chame
get_install_consentcomitem_kinddefinido comoplugine oplugin_name. Devolve os termos e umcontent_hash. - Chame
install_plugincomapp_id,plugin_nameeconsent, um objeto comaccepted, ocontent_hashque lhe foi dado e umlocale. Sem um consentimento válido a instalação é recusada e nada é escrito.
install_plugin também recebe consent_source (em que ecrã o consentimento foi aceite, apenas para o registo de auditoria), validate_free (quando verdadeiro, um plugin com preço é recusado) e version (para uma atualização, a versão que lhe foi oferecida: uma versão que não seja a mais recente é recusada).
uninstall_plugin recebe app_id e plugin_name e remove o plugin da app. Não volta a perguntar.
Carregar um plugin privado
upload_plugin guarda um pacote de plugin. Lê data.plugin_name e data.plugin_type (um de dbs, widget, graphics, library, platform, framework, util, ui) do corpo, com data.package_source (npm, o predefinido, ou xuda_hosted com um data.package_url) e data.visibility. Defina data.visibility como private para o manter fora do marketplace.
Um carregamento privado precisa da subscrição Agency ou do plano Plugins Pro do espaço de trabalho. Pôr um plugin no marketplace continua a depender da subscrição Agency. Só pode atualizar um plugin que a sua própria conta carregou.