Saltar para o conteúdo

Plugins

Extensões para o seu espaço de trabalho e as suas apps.

Abrir Plugins
Verificado com o painel em 18 de novembro de 2026

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:

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},
)

Uma boa resposta tem code 1. Uma recusada tem um code negativo e diz porquê em data.

Encontrar plugins

  • get_plugins lista os plugins do marketplace. Recebe plugin_id opcional (o id completo, com o seu prefixo @xuda.io/) ou id (sem ele), category (um tipo de plugin), limit (9999 se omitido) e skip para paginação. Os seus plugins privados são listados para si e para mais ninguém.
  • get_plugins_categories lista os tipos de plugin. Não recebe campos.
  • get_app_plugins lista os plugins instalados numa app. Recebe app_id e um plugin_type_filter opcional.

Instalar e remover um plugin de projeto

Instalar pede primeiro que os termos do plugin sejam aceites, como faz o dashboard.

  1. Chame get_install_consent com item_kind definido como plugin e o plugin_name. Devolve os termos e um content_hash.
  2. Chame install_plugin com app_id, plugin_name e consent, um objeto com accepted, o content_hash que lhe foi dado e um locale. 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.

Que tal está este guia?

Última atualização em 16 de novembro de 2026