Saltar para o conteúdo

Marketplace

Venda as suas apps aos clientes da Xuda.

Abrir Marketplace
Verificado com o painel em 19 de novembro de 2026

Vender a partir da página do Marketplace, e comprar a partir do seu checkout, fazem-se no dashboard. Criar, editar, pôr à venda e eliminar um anúncio, ler e alterar o plano de vendedor, e a própria compra não têm hoje métodos públicos. O que pode fazer a partir de código é o catálogo de plugins por trás de cada botão Instalar, e o ecrã de consentimento mostrado antes de uma instalação.

Seis métodos do catálogo são acessíveis com uma chave de API da conta: as leituras do catálogo, o ciclo de vida da instalação e o envio do pacote próprio de um plugin. Mais um, no microsserviço Marketplace, devolve o ecrã de consentimento.

Explorar e instalar

Explore o catálogo

get_plugins devolve o catálogo público (só anúncios aprovados e não privados, a não ser que passe o seu próprio uid), filtrável por category, tags e uma pesquisa de texto livre, e get_plugins_categories devolve as facetas de categoria com as suas contagens.

Veja o que já está num projeto

get_app_plugins lista o que um projeto tem instalado.

Instale

install_plugin instala um plugin indicado num app_id. uninstall_plugin remove um.

curl -s https://xuda.ai/cpi/install_plugin \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","app_id":"YOUR_APP_ID","plugin_name":"@xuda.io/example-plugin"}'
const res = await fetch('https://xuda.ai/cpi/install_plugin', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    plugin_name: '@xuda.io/example-plugin',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/install_plugin',
    json={'api_key': 'YOUR_API_KEY', 'app_id': 'YOUR_APP_ID', 'plugin_name': '@xuda.io/example-plugin'},
)
Os ids saem sem âmbito

get_plugins retira o prefixo de âmbito @xuda.io/ do _id que devolve. Volte a acrescentá-lo quando passar um nome de plugin a install_plugin.

get_install_consent, no próprio microsserviço Marketplace, devolve o ecrã de consentimento de um agente de IA ou plugin: o que faz, quem o publicou, o texto de responsabilidade e o hash de conteúdo que uma instalação tem de devolver, antes de install_plugin correr.

Publicar um plugin

upload_plugin cria ou atualiza o documento de listagem de um plugin, enviando o seu pacote e metadados. Colocar um plugin no Marketplace exige o plano Agency ou superior. Um envio privado também é permitido pelo plano Plugins da área de trabalho em que é enviado. Enviar visibility: "private" ou skip_publish_review: true mantém-no fora da fila de revisão e fora do catálogo público, para uma atualização de código ou de npm que não deva reabrir a revisão.

Anúncios que vende

Os anúncios das suas próprias aplicações, tal como a página do Marketplace os cria, gerem-se a partir do dashboard: a janela do anúncio e a página de novo anúncio fazem-no controlo a controlo. O seu plano de vendedor está na janela de planos.

Que tal está este guia?

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