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

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
}
Смотрите также

Методы REST API

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

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