Custom Speed Test

Runs a full speed test against a specific test server.

Use Cases:

• Test performance to specific regions
• Compare different server locations
• Validate network routing
• Geographic performance testing

Note: Server must be available (check /servers endpoint first).

POST /custom

Run Test on Custom Server

cURL

curl --request POST \
  --url https://api.hixbe.com/speedtest/custom \
  --header 'Content-Type: application/json' \
  --header 'Hixbe-Version: <hixbe-version>' \
  --data '{
  "serverId": 1
}'

200

{
  "success": true,
  "timestamp": "2023-11-07T05:31:56Z",
  "executionTime": "<string>"
}

Executes a custom speed test with user-defined parameters and test options.

Headers

Hixbe-Version · string · required

API version header. Required for all endpoints except / and /health

Pattern: ^\d+\.\d+\.\d+$

Example:

"2.0.0"

Body

application/json

serverId · integer · required

ID of the test server to use

Required range: x >= 1

Example:

1

Response

200

application/json

Custom server test completed successfully

success · boolean

timestamp · string<date-time>

data · object

Show child attributes

executionTime · string