Core Services APIs
Die Basisinstallation des BPCs (Core Services) bietet eine Vielzahl an API Endpunkten an. Die Dokumentation aller Endpunkte kann auf der Gesamtübersicht angesehen werden.
Darüber hinaus kann die Dokumentation für einzelne Services hier erreicht werden:
- Audit Log API
-
The audit log collects information on user activities within the application. These endpoints allow to post custom audit logs and to get a link to the monitor corresponding to the audit log.
- Authentication API
-
The Authentication API handles the processes of verifying a user’s identity and managing their session within the system.
- BOM API
-
The Bill-of-Materials (BOM) is an aggregation of all software dependencies the BPC modules/bundles have. These endpoints allow to list, retrieve, download and force-reload all available BOMs.
To get listed the modules/bundles must place their BOM to the file
/META-INF/bom.json. - Backups API
-
These endpoints allow to create, delete, restore and retrieve BPC backups.
- Collaboration API
-
These endpoints provide collaboration functionality. Currently, only the listing of all active users is available.
- Configuration API
-
These endpoints allow to retrieve, delete and post configurations for BPC modules and module instances.
- Configuration File API
-
These endpoints allow to set properties in the BPC related Karaf properties file:
etc/de.virtimo.bpc.core.cfg - Data Lock API
-
The data lock endpoints are tightly tied to OpenSearch (responses). Please try to use the storage endpoints instead.
- Deployment API
-
The deployment functionality allows to transfer configurations of one BPC instance to another.
- Event API
-
BPC has an event system to inform clients of certain events to trigger corresponding actions. This API allows to post events that can be received by targeted BPC users.
- File Storage API
-
File storage endpoints provide functionality to store files and binary data through configured file storage backend connections.
- Flow API
-
Flow is a special case of HTTP proxy functionality used for the connection with the process engines IGUASU and INUBIT. This API provides endpoints to make
GET,POST,PUTandDELETErequests using these specialized proxies. - Frontend Logging API
-
The aim of the Frontend Log Service is to make client-side logging (e.g. JavaScript console outputs) accessible within the backend. This API provides an endpoint to post these logs.
- Global Search API
-
These are the endpoints for the global search frontend.
- Http Proxy API
-
The BPC allows to setup HTTP proxy connections to make calls through the applications, e.g. to reach external resources which need authentication or can only be reached via a proxy. These endpoints allow to make calls using the defined HTTP proxies. The API supports the following HTTP methods:
GET,POST,PUT,DELETE,PATCHandOPTIONS. - Identity Management API
-
These endpoints allow to interact with the configured identity provider.
Please note, that not all functions are supported by all identity providers. In case a function is not supported, an UnsupportedOperationException gets thrown. All calls - except the GET methods - are logged in the audit log.
- Internationalization API
-
These endpoints allow to retrieve available languages and translations.
- Log Service API
-
The log service allows to store data in OpenSearch indices and databases. After configuring log service instances, these endpoints can be used to create, update and delete log entries.
- Loggers API
-
These endpoints allow to retrieve all loggers with their log level and to set the log level.
Loggers are defined in the file:
[karaf]/etc/org.ops4j.pax.logging.cfg - Lookup Joins API
-
Lookup joins are used in the replication process to replicate data from Databases, where the replicated data lies in multiple tables.
- Notification API
-
The BPC has a notification functionality to inform users. This API contains endpoints to use this notification system, e.g. to send, update, delete and retrieve notifications.
- OpenSearch API
-
These endpoints allow to list, delete and reindex OpenSearch indices as well as to receive index mappings.
- Performance Measurement API
-
The BPC performs performance monitoring to record runtimes in the BPC frontend. Measurements can be transmitted using this endpoint.
- Replication API
-
These endpoints allow to control the replication from a Database to OpenSearch.
- Security Check API
-
The Security Check API provides information about internal security checks.
- Server API
-
These endpoints allow to list all BPC instances in a cluster and to retrieve information about a specific instance.
Please be sure that every BPC server in the cluster uses a unique UUID. This is done by the setting
de.virtimo.bpc.core.karaf.uuidwhich can found in the config file[karaf]/etc/de.virtimo.bpc.core.cfg. - Status API
-
The Status API allows to retrieve certain status information (e.g. availability, healthiness) of the BPC.
- Storage API
-
Modules can use the Storage API to store custom data in specific storage indices. This API provides additional filtering and read and write restrictions with respect to users, roles and organizations.