API that enforces DiSSCo requirements for PID kernel records.
Four Types of PID records can be created: Handle records, DOI records, Digital Specimen records, and Botany Specimen records. Each subsequent record's attributes builds on the previous record Type, i.e. a Digital Specimen Record contains all attributes in a DOI record, which contains all attributes in a Handle record. More information regarding each Type's attributes can be found in the DiSSCo Data Model documentation (which is a living specification).
The API performs read/write/update operations on the Handle System via a PostgreSQL database. The database is configured within DiSSCo's Local Handle Server to automatically syncrhonize with the Handle System. For more information on the Handle System, see CNRI's Handle Technical Manual.
The prefix assigned to DiSSCo is 20.5000.1025/. Suffixes minted are 9 characters long, with dashes
every 3 characters, [A-Z;0-9] excluding I (capital i) and O (capital o).
Example: 20.5000.1025/E3W-9A2-413.
The API is documented with a Swagger endpoint.
This API adheres to JsonApi Standard where appropriate. Endpoints intended for internal use may divert from the standard. Updating and archiving endpoints return only the updated fields of the object, not the complete object. This is done to minimize the traffic load and time for the update of the handles.
spring.datasource.url - JDBC URL of the database
spring.datasource.username - Username of the database user with sufficient rights
spring.datasource.password - Password for the User
spring.security.oauth2.resourceserver.jwt.issuer-uri - Resource server for keycloak
spring.security.oauth2.authorizationserver.endpoint.jwk-set-uri - Keycloak Token Endpoint
application.ui-url
application.api-url
application.orchestration-url
application.max-handles