API-WEB Service
A gateway offering a labels layer in order to allow for multi-language applications, offering standard forms used to display object metadata in an appropriate manner - and offering functionality to cope with user settings and associated issues.
Characteristics
Service Name | apiweb |
---|---|
Port Range | 7550 |
Profiles | prod,docker,kubernetes |
Helm Chart | client |
Public API | Web-API Gateway Endpoints |
Function
The web-API gateway (API-WEB) service is beside the USERSERVICE and the Viewer Service the main service for yuuvis® client as reference implementation. First of all, the service allows configuring the labels of object types and field names that should be shown to the users depending on the language the user has set in the client. The second feature is to deliver standard forms for each object type and for the situations CREATE and EDIT, and maybe for SEARCH if necessary later on.
Currently, the API-WEB (web-api gateway) service offers several endpoints for storing this JSON-formatted data. We offer a Swagger UI for developers with information on the URLs for the endpoints of GET, POST, PATCH or DELETE calls and the possibility to ty out: https://<host>/api-web/swagger-ui.html
Additionally, our ARCHITECT Service provides yuuvis® architect as a tool with graphical user interface supporting you in managing these labels.
>> yuuvis® architect will support you in managing these labels. There is a Swagger-UI where administrators are supported by interfaces to maintain the data manually.
Requirements
>> yuuvis® Momentum Requirements - Web-API Gateway
Configuration
It is possible to specify configuration parameters in a file called api-web-prod.yml
that is located in the Git root directory like the profile-related configuration files used by the core services.
>> Configuring Services using Profiles
The following parameters can be specified:
Parameter | Description | Default | |
---|---|---|---|
csv | Section of parameters for the export of search result lists via the endpoint POST /api-web/api/dms/objects/export. | ||
delimiter | Separator between individual values. | ; | |
encoding | Used encoding. | UTF-8 | |
batchSize | Maximum number of objects to be requested simultaneously by yuuvis® core-service | 100 |