Autoxing REST API Book
  • English
  • zh-CN
GitHub
  • English
  • zh-CN
GitHub
  • Guide

    • Getting Started
    • Start Moving
    • Getting Started with WebSockets
    • Robot Admin (Standalone Version)
  • Reference

    • REST API Principles
    • Map API
    • Move API
    • Current Map and Pose API
    • Overlays
    • Mapping API
    • Service API
    • Forwarded ROS Services API
    • IoT Devices
    • Device Information API
    • Robot Parameters API
    • System Settings
    • App Store API
    • Hostname API
    • Landmarks
    • WebSocket Reference
    • Submaps
  • Other

    • Deprecations
    • Changelog

Hostname API

This service is used to manage local DNS entries (add, delete, or update):

List Available Hostnames

curl http://192.168.25.25:8090/hostnames/
[
  {
    "hostname": "local.autoxing.com",
    "url": "http://192.168.25.25:8090/hostnames/local.autoxing.com"
  }
]

Add or Update a Hostname

curl -X PATCH \
  -H "Content-Type: application/json" \
  -d '{"ip": "192.168.10.12"}' \
  http://192.168.25.25:8090/hostnames/local.autoxing.com
{
  "message": "192.168.10.12 local.autoxing.com added"
}
// status = 400
{
  "message": "error: local2.autoxing.com is not allowed. It must be one of ['local.autoxing.com']"
}

Get Hostname Details

curl http://192.168.25.25:8090/hostnames/local.autoxing.com
{
  "ip": "192.168.20.20"
}
// status = 404
{
  "message": "error: local.autoxing.com not found"
}

Delete a Hostname

curl -X DELETE http://192.168.25.25:8090/hostnames/local.autoxing.com
{
  "message": "error: Hostname local.autoxing.com deleted"
}
// status = 404
{
  "message": "error: local.autoxing.com not found"
}
Edit this page
Last Updated: 6/14/26, 5:36 AM
Contributors: FengZhaolin
Prev
App Store API
Next
Landmarks