Skip to main content

Response Message Format

Type: WEBSOCKET

Description: Server response message schema for WebSocket API operations (acknowledgements and errors).

Parameters

NameTypeMandatoryDefaultDescriptionRanges
idstringfalse-Echoed client callback ID used to correlate request/response.-
codeintegertrue-Result code. 0 = success; non‑zero indicates error.0=success; 1=fail; 2=listenKey invalid; 401=token expire
msgstringfalse""Additional message or error description.-

Response Format

format
{
"id": "{id}", // callback ID
"code": 1, // result: 0=success; 1=fail; 2=listenKey invalid
"msg": ""
}

Response Examples

Response-success
{"id": "123", "code": 0, "msg": "success"}
response-token invalid
{"id": "123", "code": 401, "msg": "token expire"}