RS485 Transceive Command

Send raw bus data to an RS485-capable device and wait for a slave response. The service does not interpret Modbus fields; the caller builds the request, handles CRC, and parses the response.

Endpoint and Permission

POST /wlte/v1/devices/{deviceId}/rs485/transceive

Requires device:control.

Request

POST {baseUrl}/wlte/v1/devices/{deviceId}/rs485/transceive
Authorization: Bearer {accessToken}
Content-Type: application/json
Idempotency-Key: <caller-generated unique value>

{
  "requestHex": "02060034000109F7"
}

requestHex is a continuous hexadecimal string containing 1 to 30 bytes, without spaces, a 0x prefix, or separators.

Success Response

{
  "code": "COMMAND_ACCEPTED",
  "message": "Command accepted.",
  "requestId": "req_001",
  "data": {
    "command": {
      "id": "cmd_001",
      "deviceId": "rek053537488",
      "operation": "device.rs485.transceive",
      "status": "SUCCESS",
      "params": {
        "requestHex": "02060034000109F7"
      },
      "result": {
        "responseHex": "02060034000109F7"
      },
      "createdAt": "2026-07-15T08:30:00Z"
    }
  }
}

The HTTP status is 202 Accepted.

• params.requestHex is the normalized request data.
• result.responseHex is returned only after a slave response arrives.
• TIMEOUT means no response arrived in the wait window and result is omitted.
• SENT means the original command for the same idempotency key is still pending.

Idempotency and Retries

Use a new Idempotency-Key for a new transceive operation. Reuse the original key only when no definitive HTTP response was received, or when retrying the identical request after rate limiting. Reusing a key with different request data returns IDEMPOTENCY_CONFLICT.

After the command returns TIMEOUT, reusing the original key returns the same commandId and TIMEOUT without sending the RS485 data again. Use a new key only after determining that a new transceive operation is safe.

Use data.command.id with Get Command Result.

Possible errors include INVALID_REQUEST, AUTH_SCOPE_DENIED, DEVICE_NOT_FOUND, DEVICE_BUSY, DEVICE_OFFLINE, IDEMPOTENCY_CONFLICT, COMMAND_REJECTED, RATE_LIMITED, GATEWAY_UNAVAILABLE, and INTERNAL_ERROR.