API de plugins¶
Los endpoints en torno a los plugins: instalarlos y gestionarlos (administrador), los webhooks (administrador) y las preferencias que la interfaz de un plugin guarda para cada usuario. Escribir un plugin es otro contrato, por gRPC sobre un socket local: consulta Escribir un plugin y la Referencia de la API de plugins.
| Especificación | Descripción |
|---|---|
| admin_plugin.swagger.json | Instalar, activar, desactivar y desinstalar plugins; configuración, registros, límites de recursos, runtimes; vista previa y aplicación de una actualización; IssuePluginToken |
| webhook.swagger.json | Crear, listar, modificar y borrar webhooks; historial de envíos |
| plugin_prefs.swagger.json | Las preferencias por usuario de la interfaz de un plugin (el permiso prefs) |
Subir un paquete es un POST /api/v1/admin/plugins/upload multipart
(campos plugin, sig opcional, accept_permission_changes); POST
/api/v1/admin/plugins/preview lo analiza sin instalarlo. Las dos son rutas
de administrador.
Autenticación¶
La gestión de plugins y los webhooks necesitan un administrador, como la
API de administración. plugin_prefs es el único
servicio pensado para un token de plugin: la página anfitriona lo emite para
un plugin y un usuario, y el servicio solo responde con las filas de esa
pareja (API del servidor).