Admin

This page describes administrative APIs and methods.

admin_auth

Create an RPC session token to be used as the authorization token for request to private JSON-RPC API endpoints.

Parameters

Argument	Type	Description
username	String	The RPC username.
password	String	The RPC password.

Curl Example:

curl -X POST --data '{"jsonrpc":"2.0","method":"admin_auth", "params": { "username": "myuser", "password":"mypass" } ,"id":21}'

Console Example

> admin.auth({
    "username": "myuser",
    "password": "mypass"
})

Returns:

String - JSON Web Token

Output:

{
  "id": 21,
  "jsonrpc": "2.0",
  "result": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOiIyMDE4LTExLTEwVDE0OjQyOjU4LjUwNDI2MjQ2MyswMTowMCIsInVzZXJuYW1lIjoiYWRtaW4ifQ.u02jMZ-VShh6Jp18tbvxCJ1KWv6fIGXky8hh7vbgDrc"
}

admin.login

Authenticates the current console session to allow private RPC APIs to be called from the console environment. Internally, it acquires a session via admin_auth endpoint, caches the session token and sets it on every JSON-RPC requests.

Parameters

Argument	Type	Required	Description
username	String	True	The RPC username.
password	String	False	The RPC password.

If the password argument is omitted, an interactive session is started to collect the password. This is the recommended approach.

Console Example

> admin.login("myuser", "mypass")

Returns:

String - JSON Web Token

Output:

{
  "id": 21,
  "jsonrpc": "2.0",
  "result": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOiIyMDE4LTExLTEwVDE0OjQyOjU4LjUwNDI2MjQ2MyswMTowMCIsInVzZXJuYW1lIjoiYWRtaW4ifQ.u02jMZ-VShh6Jp18tbvxCJ1KWv6fIGXky8hh7vbgDrc"
}