Response envelope
{
"status": 200,
"code": "string",
"msg": "OK",
"success": true,
"traceId": "string",
"data": {}
}| Case | How to decide |
|---|---|
| Success | success == true (then read data) |
| Business failure | success == false; read msg / code; HTTP may still be 200 |
| Debugging | Always persist traceId |
msg, not message.Success example
{
"status": 200,
"code": "SUCCESS",
"msg": "OK",
"success": true,
"traceId": "a1b2c3d4e5f6",
"data": {
"orderId": "ord_123",
"orderStatus": "processing"
}
}Failure example
{
"status": 500,
"code": "AMOUNT_OUT_OF_RANGE",
"msg": "sourceAmount must be between 100 and 500000 USDT, current: 10",
"success": false,
"traceId": "a1b2c3d4e5f6",
"data": null
}