Change MAC address for dongles

POST

{{BASE_URL}}/v2/change_mac_address

Device

Updates the MAC address for one or more dongles.
This operation is supported for XProxy XH20/XH22 dongles model only.
The dongle will be rebooted automatically after the change.

Request

Body Params application/json

positions

array[integer]

required

Array of position indexes to change MAC address for

Example:

[1,2,3]

mac

object

required

mode

integer

required

MAC change mode:

0 = Fixed MAC address (set to exact value in mac field)

1 = Randomize based on MAC address (use mac field as base for randomization)

Example:

mac

string

required

MAC address to set or use as base for randomization.
Format should be XX:XX:XX:XX:XX:XX or XXXXXXXXXXXX

Example:

00:11:22:33:44:55

Example

{
    "positions": [
        1,
        2,
        3
    ],
    "mac": {
        "mode": 1,
        "mac": "00:11:22:33:44:55"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://localhost/v2/change_mac_address' \
--header 'Content-Type: application/json' \
--data-raw '{
    "positions": [
        1,
        2,
        3
    ],
    "mac": {
        "mode": 1,
        "mac": "00:11:22:33:44:55"
    }
}'

Responses

🟢200OK

application/json

Successful operation

Body

status

boolean

optional

Example:

true

msg

string

optional

Example:

Sent change MAC successfully! Please wait up to 15s to effect!

Example

{
    "status": true,
    "msg": "Sent change MAC successfully! Please wait up to 15s to effect!"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Modified at 2025-04-23 02:51:40

Add or change device note

Change APN for dongles