Entorns
L’accés a l’API pot variar en funció de l’entorn.URL base
Totes les rutes de l’API es construeixen a partir d’aquesta base: FlexxibleGenerar una clau d’API
Per crear aquesta clau és necessari que l’usuari tingui el rol d’Administrador d’organització.- Accedir a Configuració → Organització.
- Seleccionar la pestanya Claus d’API.
- Fer clic a Crear clau d’API.
-
Emplenar el formulari.
- Nom. Identificador de la clau API.
- Rol. Rol assignat a l’usuari a Portal.
- Durada. Temps de validesa de la clau.
- Confirmar amb Desa.
Autenticar les sol·licituds
Totes les peticions han d’incloure la clau a la capçalera Authentication utilitzant l’esquema Bearer: Authentication: Bearer<api_key>
Tot i que s’utilitza l’esquema Bearer, el valor correspon directament a una clau d’API generada a la plataforma i no a un token obtingut mitjançant un procés d’autenticació addicional.
Obtenir l’ID de l’organització
Cada endpoint requereix l’ID de l’organització com a primer segment de la ruta.https://api.flexxible.net/v2/organizations/:organization_id/{endpoint}
Per trobar l’ID de l’organització:
- Accedir a Configuració → Organització.
- Seleccionar la pestanya General → Detalls.
- Copiar l’identificador.
Contracte OpenAPI
Descarrega el contracte OpenAPI en format JSON per consultar l’especificació completa de l’API i facilitar les integracions.Límits
Per garantir l’estabilitat, el rendiment i la disponibilitat del servei, la plataforma aplica límits lògics al nombre màxim d’elements que un tenant pot emmagatzemar de cada entitat disponible a l’API. Aquests límits no corresponen a límits de peticions a l’API (rate limits), sinó que defineixen la quantitat màxima d’elements de cada tipus d’entitat que un tenant pot tenir en un moment donat. Aquests límits s’apliquen de manera predeterminada a tots els entorns.| Entitat | Límit d’elements |
|---|---|
| Tenants i tenants delegats | 100 |
| Organitzacions | 100 |
| Grups de reporte | 500 |
| Grups de workspaces | 1000 |
| Grups de workspaces → Programació | 10 |
| Fluxos | 100 |
| Microserveis | 500 |
| Informes | 500 |
| Web Apps | 100 |
| Webhooks | 100 |
| Llicències | 500 |
| Configuració d’alertes | 100 |
| Rols | 100 |
| Usuaris | 1500 |
| Actualitzacions → Directives | 50 |
| Actualitzacions → Targets | 50 |
| Directives | 50 |
| Integracions | 10 |
| Categories d’informes | 100 |
| Categories de microserveis | 100 |
| Dominis | 5 |
| Integracions SSO | 5 |
| Productes | 15 |
| Mòduls | 50 |
| API Keys | 15 |