Установка и использование платформы

REST API: информация о ролях участников

https://img.shields.io/badge/auth-required-orange.svg

Для получения информации о ролях участников в сети предназначены методы группы permissions.

Подробнее о ролях участников см. статью Роли участников.

GET permissions/{address}

Метод возвращает информацию об активных ролях участника, адрес или псевдоним (алиас) которого указан как {address}, а также время формирования запроса в формате Unix Timestamp (в миллисекундах).

Пример ответа:

GET permissions/{address}:
{
  "roles": [
      {
      "role": "miner"
      },
      {
      "role": "permissioner"
      }
  ],
  "timestamp": 1544703449430
}

GET permissions/{address}/at/{timestamp}

Метод возвращает информацию о ролях участника, адрес или псевдоним (алиас) которого указан как {address}, активных на момент времени {timestamp}. Время указывается в формате Unix Timestamp (в миллисекундах).

Пример ответа:

GET permissions/{address}/at/{timestamp}:
{
  "roles": [
      {
      "role": "miner"
      },
      {
      "role": "permissioner"
      }
  ],
  "timestamp": 1544703449430
}

POST permissions/addresses

Метод возвращает роли для нескольких адресов или псевдонимов (алиасов), активные на указанный момент времени.

В запросе передаются следующие данные:

  • addresses - список адресов в виде массива строк;

  • timestamp - время в формате Unix Timestamp (в миллисекундах).

Пример запроса с двумя адресами:

POST permissions/addresses:
{
    "addresses": [
        "3N2cQFfUDzG2iujBrFTnD2TAsCNohDxYu8w", "3Mx5sDq4NXef1BRzJRAofa3orYFxLanxmd7"
    ],
    "timestamp": 1544703449430
}

В ответе метода возвращается массив данных addressToRoles, в котором указаны роли для каждого адреса, а также время timestamp.

Пример ответа для двух адресов:

POST permissions/addresses:
{
    "addressToRoles": [
        {
        "address": "3N2cQFfUDzG2iujBrFTnD2TAsCNohDxYu8w",
        "roles": [
            {
              "role": "miner"
            },
            {
              "role": "permissioner"
            }
        ]
        },
        {
        "address": "3Mx5sDq4NXef1BRzJRAofa3orYFxLanxmd7",
        "roles": [
            {
              "role": "miner"
            }
        ]
        }
    ],
    "timestamp": 1544703449430
}

GET permissions/contract-validators

Метод возвращает список адресов участников с ролью contract_validator на текущей высоте.

Пример ответа:

GET permissions/contract-validators:
{"addresses":

  ["3MqtxeditbhzQgsacp3wHgqBUHy6NZRfu4r","3NC1yzCd6MwprcXbqZAqjicXiryofpxQMwo","3NCzThL6uRzBYAhF8YBs1n8y2wT4KCAVGYA","3MxYvon6fbNonaJ1Vhun3hU6BSmiuCJRFgQ","3MuwvZifNZZ9Y197i1NHuoUBtXe6KSyjAKQ","3N1ojYLdheCzhBWi9UFTc6DgboHmkCjXnsZ","3N7LcRz5rkEupTFEmkrnwNcvJRWyc8g4Lf7","3N1rxLXia8t7zeLJbPhP2DQPuMu4fyNivry","3NB8PDMLAmU68fZkrtWiRg5vbRo1vPXi4XV","3MxuvmPMrBnGLXMLK4a3cHo9b8C1DjepppE","3NBKpghU6LLVCQ9YnuSELK1tsmpAsqW47tM"]

}

GET permissions/contract-validators/{height}

Метод возвращает список адресов участников с ролью contract_validator на заданной высоте. Выполняется проверка того, что переданное значение высоты больше 0 и меньше текущей высоты блокчейна.

Пример ответа:

GET permissions/contract-validators/{height}:
{"addresses":

  ["3MqtxeditbhzQgsacp3wHgqBUHy6NZRfu4r","3NC1yzCd6MwprcXbqZAqjicXiryofpxQMwo","3NCzThL6uRzBYAhF8YBs1n8y2wT4KCAVGYA","3MxYvon6fbNonaJ1Vhun3hU6BSmiuCJRFgQ","3MuwvZifNZZ9Y197i1NHuoUBtXe6KSyjAKQ","3N1ojYLdheCzhBWi9UFTc6DgboHmkCjXnsZ","3N7LcRz5rkEupTFEmkrnwNcvJRWyc8g4Lf7","3N1rxLXia8t7zeLJbPhP2DQPuMu4fyNivry","3NB8PDMLAmU68fZkrtWiRg5vbRo1vPXi4XV","3MxuvmPMrBnGLXMLK4a3cHo9b8C1DjepppE","3NBKpghU6LLVCQ9YnuSELK1tsmpAsqW47tM"]

}
Смотрите также

Методы REST API

Роли участников

Управление ролями участников