Database Access

Access to the database linked to a microservice is exclusively delegated to the core APIs (query and/or write). Therefore, a microservice for reading or writing data in the database will need to invoke the endpoints exposed by the core service, to which the correct information must be provided so that the latter can (via the query/write API) access the correct database.

Transmission of Source Information

To instruct the core service correctly and ensure that data reading/writing occurs properly in the desired database, it is necessary to add a key to the headers in API calls.

This operation is handled directly by the libraries present in each microservice, which redirect CRUD calls to the core service. However, it is necessary to manually modify the headers if such libraries are not used (for example, when implementing specific endpoints in a microservice and it is necessary to obtain data from the reference database).

The key to be used and added to the headers is microservice: [microserviceId].

Accept:application/json
Content-Type:application/json
Authorization: Bearer Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.
eyJpc3MiOiJwb3dlcjJyZXRhaWwuY29tIiwiYXVkIjoiaHR0cDpcL1wva2V0Y2hhcHAucG93ZXIycmV0YWlsLmNvbSIsImlhdCI6MTU4NTczNDUz
NCwibmJmIjoxNTg1NzM0NTM0LCJleHAiOjE1ODU3MzU0MzQsInNlc3Npb25JZCI6IjIxMiJ9.
klDHrQLTjZdUNzhd0RNsw6TwrXmahreQyEMANk38gXpc_oBhVebQ87tvXmw1DNNZcga3R2FHRpzS6yM3q61hkL93cq1TW0hfAN6f7-
FXHXpPKRMkoPJAXd9hh31pQRNjb1-hoO3etbpWVEHij7mcPYP4WhNC-MuRlGY-Y_Al-ME
microservice: mssettings

Through the "microservice" key present in the header, the core write and query components will know how to retrieve information related to the database to be queried.

Note: The system will verify that the code sent (currently in plain text, but a unique identification code will be created shortly) is valid and that the call is authorized.

Below is a diagram showing the sequential flow of how to obtain data from the database of a microservice.