Saltar al contenido

Plugins

Complementos para tu espacio de trabajo y tus apps.

Abrir Plugins
Comprobado con el panel el 18 de noviembre de 2026

Plugins tiene seis métodos públicos. Enumeran plugins y gestionan los plugins que se ejecutan con un proyecto en los servidores de Xuda, el segundo carril de la página Plugins. Cada uno actúa por la cuenta cuya clave de API uses.

Añadir un plugin al servidor del espacio de trabajo, crear uno, ejecutarlo y configurar sus claves se hacen en el dashboard. Hoy no tienen método público, y install_plugin rechaza un plugin que solo se ejecuta en un servidor de espacio de trabajo.

Envía una solicitud a un método con tu clave. Esta enumera los widgets del 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},
)

Una buena respuesta tiene code 1. Una rechazada tiene un code negativo y dice por qué en data.

Encuentra plugins

  • get_plugins enumera los plugins del marketplace. Toma plugin_id opcional (el id completo, con su prefijo @xuda.io/) o id (sin él), category (un tipo de plugin), limit (9999 si se omite) y skip para paginar. Tus propios plugins privados se enumeran para ti y para nadie más.
  • get_plugins_categories enumera los tipos de plugin. No toma campos.
  • get_app_plugins enumera los plugins instalados en una app. Toma app_id y un plugin_type_filter opcional.

Instala y quita un plugin de proyecto

Instalar pide primero que se acepten los términos del plugin, como hace el dashboard.

  1. Llama a get_install_consent con item_kind igual a plugin y el plugin_name. Devuelve los términos y un content_hash.
  2. Llama a install_plugin con app_id, plugin_name y consent, un objeto con accepted, el content_hash que te dieron y un locale. Sin un consentimiento válido, la instalación se rechaza y no se escribe nada.

install_plugin también toma consent_source (en qué pantalla se aceptó el consentimiento, solo para el registro de auditoría), validate_free (si es verdadero, se rechaza un plugin con precio) y version (para una actualización, la versión que se te ofreció: una versión que no es la última se rechaza).

uninstall_plugin toma app_id y plugin_name y quita el plugin de la app. No vuelve a preguntar.

Sube un plugin privado

upload_plugin guarda un paquete de plugin. Lee data.plugin_name y data.plugin_type (uno de dbs, widget, graphics, library, platform, framework, util, ui) del cuerpo, con data.package_source (npm, el predeterminado, o xuda_hosted con un data.package_url) y data.visibility. Define data.visibility como private para mantenerlo fuera del marketplace.

Una subida privada requiere la suscripción Agency o el plan Plugins Pro del espacio de trabajo. Poner un plugin en el marketplace sigue siendo cosa de la suscripción Agency. Solo puedes actualizar un plugin que subió tu propia cuenta.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026