Installation and usage of the platform

REST API methods

The REST API allows users to remotely interact with a node via JSON requests and responses. The API is accessed via the https protocol. The Swagger framework is used as an interface to the REST API.

REST API usage

All REST API method calls are HTTP GET, POST or DELETE requests to URL https://yournetwork.com/node-N, containing the corresponding parameter sets.

The platform also provides access to the Swagger https://yournetwork.com/node-N/api-docs/index.html interface, which allows you to make and send HTTP requests to the node through the web interface. The desired groups of requests can be selected in the Swagger interface by selecting routes – the URLs to individual REST API methods.

At the end of each route there is an endpoint – a reference to the method.

Example of a UTX pool size query:

Пример запроса

The port for listening to the REST API requests is specified in the api.rest.port parameter of the node configuration file; generally the 6862 port is used.

Almost all REST API methods require authorization by api-key or JWT token (oAuth2 authorization). The authorization method is set in the auth section of the node configuration file.

When authorizing by api-key, specify the value of the selected key phrase, and when authorizing by JWT-token specify the access-token value.

When JWT token authorization is used, the user is assigned a role (or several roles), which determines certain REST API methods accessibility. For more details see Authorization service and OAuth2 authorization roles sections.