Download OpenAPI specification:

configuration

Get consume configuration

Get current consume mode setting (true = delete-on-read, false = keep data in queue)

Responses

Response samples

Content type
application/json
{
  • "consume": true
}

Update consume configuration

Update consume mode setting (true = delete-on-read, false = keep data in queue)

Request Body schema: application/json
required

Consume configuration

consume
boolean

Responses

Request samples

Content type
application/json
{
  • "consume": true
}

Response samples

Content type
application/json
{
  • "consume": true
}

Get queue configuration

Get current queue size configuration for TRNG and Fortuna data

Responses

Response samples

Content type
application/json
{
  • "fortuna_queue_size": 10,
  • "trng_queue_size": 10
}

Update queue configuration

Update queue size configuration for TRNG and Fortuna data

Request Body schema: application/json
required

Queue configuration

fortuna_queue_size
required
integer [ 10 .. 1000000 ]
trng_queue_size
required
integer [ 10 .. 1000000 ]

Responses

Request samples

Content type
application/json
{
  • "fortuna_queue_size": 10,
  • "trng_queue_size": 10
}

Response samples

Content type
application/json
{
  • "fortuna_queue_size": 10,
  • "trng_queue_size": 10
}

data

Get random data

Retrieve random data in various formats with pagination

Request Body schema: application/json
required

Data request parameters

format
required
string
Enum: "int8" "int16" "int32" "int64" "uint8" "uint16" "uint32" "uint64" "binary"
limit
required
integer [ 1 .. 100000 ]
offset
integer >= 0
source
required
string
Enum: "trng" "fortuna"

Responses

Request samples

Content type
application/json
{
  • "format": "int8",
  • "limit": 1,
  • "offset": 0,
  • "source": "trng"
}

Response samples

Content type
[
  • null
]

status

Health check endpoint

Checks health of the API server and its dependencies

Responses

Response samples

Content type
application/json
{
  • "details": {
    },
  • "status": "string",
  • "timestamp": "string"
}

Get system status

Get detailed status of TRNG and Fortuna systems with comprehensive metrics

Responses

Response samples

Content type
application/json
{
  • "database": {
    },
  • "fortuna": {
    },
  • "trng": {
    }
}