Cómo activar un Bearer Token para acceso a las API

¿Qué es una API?

Una API (Interfaz de Programación de Aplicaciones) es un conjunto de reglas y protocolos que permite que diferentes aplicaciones se comuniquen entre sí de forma estructurada.

Dicho de forma más simple: una API actúa como un puente entre dos sistemas, permitiendo que uno solicite información o ejecute acciones en el otro sin necesidad de intervención manual.

Por ejemplo:

• Una aplicación puede usar una API para crear automáticamente un dominio.
• Un sistema externo puede consultar el estado de un servicio sin acceder directamente al panel.

En el caso de SWPanel, su API permite gestionar dominios, servicios y recursos de forma programática, facilitando la automatización y la integración con otros sistemas.

¿Qué es un Bearer Token?

Un Bearer Token es un tipo de credencial de seguridad que se utiliza para autenticar las peticiones a una API.

• Funciona como una clave de acceso privada
• Permite identificar al usuario que realiza la solicitud
• Se envía en cada petición a la API para autorizar la acción

Concepto clave:
Cualquier persona que tenga acceso a un Bearer Token puede usar la API con los permisos asociados a ese token.

Por eso es fundamental:

• No compartirlo públicamente
• Almacenarlo de forma segura
• Revocarlo si se sospecha que ha sido comprometido

¿Cómo funciona y para qué sirve la API de SWPanel?

La API de SWPanel permite realizar las mismas acciones que normalmente harías desde la interfaz del panel, pero de forma automatizada.

Esto incluye, por ejemplo:

• Crear o eliminar dominios
• Gestionar servicios
• Automatizar tareas repetitivas
• Integrar SWPanel con sistemas externos (CRM, ERP, aplicaciones propias, etc.)

Está diseñada para:

• Reducir la intervención manual
• Mejorar la eficiencia operativa
• Facilitar integraciones con otras plataformas

Activación de la API

SWPanel dispone de varios modos de funcionamiento. La gestión de APIs solo está disponible en el modo Integrador, por lo que primero deberás activarlo.

Activar el modo Integrador

1. Accede al menú superior de SWPanel

2. Pulsa en la pestaña "Mi SWPanel"

3. Selecciona "Preferencias de SWPanel" o directamente "Cambio modo de funcionamiento"

   

4. Accede a la pestaña "Funcionamiento"

5. Selecciona el modo "Integrador"

   

6. Guarda los cambios

7. Regresa al Dashboard

8. Haz clic en tu avatar para abrir el menú superior

9. Accede a la pestaña "Modo Integrador"

10. Pulsa en "Activar APIs de SWPanel"

    

11. Lee la información mostrada y acepta la activación

    

12. Una vez activadas las APIs, el menú de Modo Integrador mostrará nuevas opciones

13. Accede al Dashboard del modo Integrador

    

14. Desde el Dashboard podrás ver tu Bearer Token, acceder a la documentación de la API y gestionar su uso

    

Gestión de Bearer Tokens

SWPanel permite crear y gestionar múltiples Bearer Tokens con diferentes configuraciones.

Esto es especialmente útil para:

• Equipos de desarrollo
• Integraciones múltiples
• Control de accesos por aplicación

¿Por qué usar varios tokens?

• Separar entornos (producción, desarrollo)
• Limitar permisos por aplicación
• Revocar accesos sin afectar a otros sistemas

Cómo gestionar tus Bearer Tokens

1. Accede al menú superior de SWPanel

2. Entra en la pestaña "Modo Integrador"

3. En la sección "Gestionar APIs de SWPanel", selecciona "Gestionar Bearer Tokens"

   

4. Visualiza el listado de tokens existentes

5. Utiliza las opciones disponibles para crear, editar o revocar tokens

Crear un nuevo Bearer Token

1. Pulsa en "Crear nuevo Bearer Token"

   

2. Completa los campos requeridos:

   • Nombre descriptivo
   • Permisos
   • Configuración de seguridad

3. Guarda la configuración

   

Recomendación:

• Utiliza nombres descriptivos como:
  • crm-produccion
  • script-backups
  • integracion-facturacion

Buenas prácticas de seguridad

1. No compartas tus tokens en código público
2. Usa diferentes tokens para cada integración
3. Revoca tokens que ya no se utilicen
4. Aplica el principio de menor privilegio (solo los permisos necesarios)

Más opciones del Modo Integrador

El modo Integrador ofrece herramientas adicionales para trabajar con las APIs de SWPanel.

Consulta el manual completo para profundizar en todas sus funcionalidades.

Documentación adicional

Si lo deseas puedes consultar la documentación técnica especifica de cada uno de los EndPoints de las APIs de SWPanel en el siguiente enlace: Documentación técnica

info_capture Nota: La capturas de este manual han sido tomadas sobre la versión 2026.001.0020 con fecha 27/04/2026. Puede diferir de la versión actual de SWPanel y simplemente deben tomarse como orientativas