Initial Set-Up

Complete these operations before embarking on writing, reading and verifying † records.

Configure REST API Info

The API URL and the associated key and means of using the key will be provided by your supplier. We set them up as variables to make the endpoints easier to use in the subsequent examples.

Example code:

cURL

URL=https://nchainplatform.com/products/api/2cdee07fe....45d58e65537f39

KEY=b6519d3c56c....6746131380159bb9

JavaScript

const url = "https://nchainplatform.com/products/api/2cdee07fe....45d58e65537f39";

const key = "b6519d3c56c....6746131380159bb9";

Check Readiness

This enables you to check that the program is initially working and find out its version number.

Example code:

cURL

curl "$URL/readiness" \
     -H "x-api-key: $KEY" \
     -H "accept: text/plain"

JavaScript

const response = await fetch('${url}/readiness', {
  headers: {
    'x-api-key': '{$key}',
    'accept': 'text/plain'
  }
});

Example cURL response:

{
  "appVersion": "1.4.1",
  ....
}

Chain Event uses semantic versioning as specified at https://semver.org.

Check Liveness

This enables you to check whether the program thinks it is Healthy or not. Applications that interact with nChain Event could call this every hour when they are idling.

Example code:

cURL

curl "$URL/liveness" \
     -H "x-api-key: $KEY" \
     -H "accept: text/plain"

JavaScript

const response = await fetch('${url}/liveness', {
  headers: {
    'x-api-key': `${key}`,
    'accept': 'text/plain'
  }
});

Example cURL response:

Healthy