Xentara WebSocket API Specification v2.0.4
User Manual
|
OpCode | Name | Description |
---|---|---|
0 | server_information | Retrieves server information. |
The parameter object outlined in request packet for this command includes:
ID | Name | Optional | Description |
---|---|---|---|
0 | server_information_ids | no | An array comprising integers containing values from the Server Information Identifiers. |
The response item outlined in response packet for this command includes:
Name | Type | Description |
---|---|---|
Server Information | Object | An object containing requested Xentara server information. |
The server information object contains the requested server information identifiers as keys, paired with their respective values. If an error occurs, the response will include an error packet with detailed error information.
Below is the list of the potential errors that may be encountered with this command. Further details regarding errors in the Xentara WebSocket interface can be accessed here.
Sr. No. | Error Code | Error Description |
---|---|---|
1 | -32700 | Parse Error |
2 | -32603 | Internal Error |
3 | -32602 | Invalid Parameter |
4 | -32600 | Invalid Request |
5 | -32000 | Missing Client Hello Request |
Below is an example for the request to server information of the Xentara HTTP Server. The request is made to get current xentara version and user name of the host machine using server information identifiers. The message id 65 is an arbitrary number assigned for this particular request.
[ 0, # Request Packet 65, # Message Id 0, # Server Information OpCode { # Server Information Object 0: [0, 1, 2] # Server Information Identifiers } ]
Below is an example of the successful response to the aforementioned request. It indicates a package type of 1, signifying a successful response. The provided Message ID is intended for matching with the corresponding request. The response includes an object containing the running xentara version, the username of the account and the file path to the model.
[ 1, # Packet Type - Success Response 65, # Message Id { 0: "Xentara Version", # Xentara Version 1: "User Name", # User name 2: "path/to/model/file" # Path to current model file } ]