API for Querying Client Status
This feature is currently only available to NaaS partners, enabling efficient querying of the status of multiple clients in bulk.
Prerequisite
Please make sure you obtain x-ak
& x-sk
issued by Aethir.
Query Client Online Status
Description
This interface is used to query whether the client is online.
URL
https://app.aethir.com/console-api/v2/client/onLineState
Method
POST
Rate Limit
Each x-ak
can make a request every 5 seconds.
Request Headers
Header | Type | Mandatory |
---|---|---|
x-ak | string | Yes |
x-op-token | string | Yes |
x-ak is a verification code issued to qualified partner Node Operators.
x-op-token is consists of three parts
Header
A compact JSON string encoded with base64, representing the header.
Payload
A compact JSON string encoded with base64, representing the payload.
Signature
where
sk
is a verification code issued to qualified partner Node Operators.
Request Body
The request body is an array of clientId
, supporting a maximum of 20 IDs.
Response
Possible responses and their corresponding meanings are:
HttpStatus 200
: Query successful; the query result is parsed in theHttpResponseBody
.HttpStatus 400
: Thex-op-token
format is incorrect or rate limit exceeded.HttpStatus 401
: The client needs to regenerate thex-op-token
and retry the query.
Response Body
Field | Type | Description |
---|---|---|
clientId | string | Client ID |
onLineState | int | 1: Online, 0: Offline |
Last updated