Biographic Database API (1.1.0)

Download OpenAPI specification:Download

Download Java Maven Project sample (v1.1.0): Download

This is the Biographic Database API specification.
It can retrieve biographic data from an external biographic database for GBDS using keys.

authorization

Biographic database OAuth 2.0 authorization.

authorize

Use OAuth 2.0 to authorize the API to request biographics.

Request Body schema: application/json
required

Authorization request. Provide the client ID and client secret.

clientID
string
clientSecret
string

Responses

Request samples

Content type
application/json
{
  • "clientID": "client-id",
  • "clientSecret": "client-secret"
}

Response samples

Content type
application/json
{
  • "token": "eyJhbGciOiJIUzUxMiJ9.eyJpZCI6MSwibmFtZSI6IkpvaG4ifQ.J3KLoXwPhku..."
}

biographic

External biographics from a biographic database.

listBiographics

Provide a list of one or more IDs and, for each ID provided, retrieve a list of biographics from an external biographic database using ID keys.

If the authorization token is VALID, the response will be 200 OK. It will contain an ID list with the related biographics. If no IDs are found, the return is an empty list.

If the authorization token is INVALID, the response will be 403 Forbidden.

Authorizations:
biographic_auth
Request Body schema: application/json
required

List of IDs to be retrieved with a list of keys for each ID. Only one key per ID is necessary to identify it on the server.

Array of objects (RequestId)

List of IDs to be retrieved with a list of keys.

Responses

Request samples

Content type
application/json
Example
[
  • {
    }
]

Response samples

Content type
application/json
Example
{
  • "ids": [
    ]
}

updateBiographics

Update list of biographics for a provided ID using ID keys.

Request Body schema: application/json
required

List of keys to identify an ID and list of biographics to update it with.

Array of objects (RequestKey)
Array of objects (Biographic)

Responses

Request samples

Content type
application/json
{
  • "keys": [
    ],
  • "biographics": [
    ]
}

Response samples

Content type
application/json
{
  • "status": 201,
  • "message": "Created"
}