API для Запроса Статуса Клиента

Эта функция в настоящее время доступна только для партнеров NaaS, что позволяет эффективно запрашивать статус нескольких клиентов оптом.

Предварительные требования Пожалуйста, убедитесь, что вы получили x-ak и x-sk, выданные Aethir.

Запрос статуса онлайн клиента

Описание Этот интерфейс используется для запроса о том, находится ли клиент в режиме онлайн.

URL https://app.aethir.com/console-api/v2/client/onLineState

Метод POST

Лимит запросов Каждый x-ak может отправлять запрос каждые 5 секунд.

Заголовки запроса

Header	Type	Mandatory
x-ak	string	Yes
x-op-token	string	Yes

x-ak — это код подтверждения, выданный квалифицированным партнерам-операторам узлов.

x-op-token состоит из трех частей:

x-op-token = header.payload.signature

Заголовок

Сжатая JSON-строка, закодированная в base64, представляющая заголовок.

{
  "alg": "HS256",  // Алгоритм шифрования, фиксированный как HS256
  "typ": "CHK_OP"  // Тип токена, фиксированный как CHK_OP
}

Полезная нагрузка

Сжатая JSON-строка, закодированная в base64, представляющая полезную нагрузку.

{
  "ak": "",       // Выданный AK оператора узла
  "exp": 1,       // Время истечения токена в миллисекундах, настроенное пользователем
  "ip": "",       // IP-адрес клиента
  "nonce": 1      // Случайное число, сгенерированное пользователем
}

Подпись

signature = base64UrlEncode(HmacSHA256.sign(base64UrlEncode(header) + "." + base64UrlEncode(payload), sk))

где sk — это код подтверждения, выданный квалифицированным партнерам-операторам нод.

Тело запроса

Тело запроса представляет собой массив clientId, поддерживающий максимум 20 идентификаторов.

[
  "clientId1",
  "clientId2",
  ...
]

Ответ

Возможные ответы и их соответствующие значения:

• HttpStatus 200: Запрос выполнен успешно; результат запроса разобран в HttpResponseBody.

• HttpStatus 400: Формат x-op-token неверен или превышен лимит запросов.

• HttpStatus 401: Клиенту необходимо заново сгенерировать x-op-token и повторить запрос.

Тело ответа

[
  {
    "clientId": "clientId1",
    "onLineState": 1
  }
]

Field	Type	Description
clientId	string	Client ID
onLineState	int	1: Online, 0: Offline