Com activar un Bearer Token per accés a les API

Què és una API?

Una API (Interfície de Programació d'Aplicacions) és un conjunt de regles i protocols que permet que diferents aplicacions es comuniquin entre si de manera estructurada.

Dit de manera més simple: una API actua com un pont entre dos sistemes, permetent que un sol·liciti informació o executi accions en l'altre sense necessitat d'intervenció manual.

Per exemple:

• Una aplicació pot utilitzar una API per crear automàticament un domini.
• Un sistema extern pot consultar l'estat d'un servei sense accedir directament al panell.

En el cas de SWPanel, la seva API permet gestionar dominis, serveis i recursos de manera programàtica, facilitant l'automatització i la integració amb altres sistemes.

Què és un Bearer Token?

Un Bearer Token és un tipus de credencial de seguretat que s'utilitza per autenticar les peticions a una API.

• Funciona com una clau d'accés privada
• Permet identificar l'usuari que realitza la sol·licitud
• S'envia en cada petició a l'API per autoritzar l'acció

Concepte clau:
Qualsevol persona que tingui accés a un Bearer Token pot utilitzar l'API amb els permisos associats a aquest token.

Per això és fonamental:

• No compartir-lo públicament
• Emmagatzemar-lo de manera segura
• Revocar-lo si es sospita que ha estat compromès

Com funciona i per a què serveix l'API de SWPanel?

L'API de SWPanel permet realitzar les mateixes accions que normalment faries des de la interfície del panell, però de manera automatitzada.

Això inclou, per exemple:

• Crear o eliminar dominis
• Gestionar serveis
• Automatitzar tasques repetitives
• Integrar SWPanel amb sistemes externs (CRM, ERP, aplicacions pròpies, etc.)

Està dissenyada per a:

• Reduir la intervenció manual
• Millorar l'eficiència operativa
• Facilitar integracions amb altres plataformes

Activació de l'API

SWPanel disposa de diversos modes de funcionament. La gestió d'APIs només està disponible en el mode Integrador, per la qual cosa primer hauràs d'activar-lo.

Activar el mode Integrador

1. Accedeix al menú superior de SWPanel

2. Fes clic a la pestanya "El meu SWPanel"

3. Selecciona "Preferències de SWPanel" o directament "Canvi de mode de funcionament"

   

4. Accedeix a la pestanya "Funcionament"

5. Selecciona el mode "Integrador"

   

6. Desa els canvis

7. Torna al Dashboard

8. Fes clic al teu avatar per obrir el menú superior

9. Accedeix a la pestanya "Mode Integrador"

10. Fes clic a "Activar APIs de SWPanel"

    

11. Llegeix la informació mostrada i accepta l'activació

    

12. Un cop activades les APIs, el menú de Mode Integrador mostrarà noves opcions

13. Accedeix al Dashboard del mode Integrador

    

14. Des del Dashboard podràs veure el teu Bearer Token, accedir a la documentació de l'API i gestionar-ne l'ús

    

Gestió de Bearer Tokens

SWPanel permet crear i gestionar múltiples Bearer Tokens amb diferents configuracions.

Això és especialment útil per a:

• Equips de desenvolupament
• Integracions múltiples
• Control d'accessos per aplicació

Per què utilitzar diversos tokens?

• Separar entorns (producció, desenvolupament)
• Limitar permisos per aplicació
• Revocar accessos sense afectar altres sistemes

Com gestionar els teus Bearer Tokens

1. Accedeix al menú superior de SWPanel

2. Entra a la pestanya "Mode Integrador"

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

   

4. Visualitza el llistat de tokens existents

5. Utilitza les opcions disponibles per crear, editar o revocar tokens

Crear un nou Bearer Token

1. Fes clic a "Crear nou Bearer Token"

   

2. Completa els camps requerits:

   • Nom descriptiu
   • Permisos
   • Configuració de seguretat

3. Desa la configuració

   

Recomanació:

• Utilitza noms descriptius com:
  • crm-produccio
  • script-backups
  • integracio-facturacio

Bones pràctiques de seguretat

1. No comparteixis els teus tokens en codi públic
2. Utilitza diferents tokens per a cada integració
3. Revoca els tokens que ja no s'utilitzin
4. Aplica el principi de menor privilegi (només els permisos necessaris)

Més opcions del Mode Integrador

El mode Integrador ofereix eines addicionals per treballar amb les APIs de SWPanel.

Consulta el manual complet per aprofundir en totes les seves funcionalitats.

Documentació addicional

Si ho desitges, pots consultar la documentació tècnica específica de cadascun dels EndPoints de les APIs de SWPanel al següent enllaç: Documentació tècnica

info_capture Nota: Les captures d'aquest manual han estat preses sobre la versió 2026.001.0020 amb data 27/04/2026. Pot diferir de la versió actual de SWPanel i simplement s'han de prendre com a orientatives