mayDDNS
Login

API Reference

Integrate mayDDNS with your scripts, routers, and devices.

1. DynDNS / No-IP Compatible Update

URL: https://mayddns.com/nic/update

Method: GET with Basic Authentication

Parameters:

  • hostname — Full hostname (e.g. example.mayddns.com)
  • myip — IPv4 address (auto-detected from request if omitted)
  • Authentication: Username and password from hostname details

Example:

curl -u "username:password" "https://mayddns.com/nic/update?hostname=example.mayddns.com&myip=1.2.3.4"

2. mayDDNS Update via UUID

  • IPv4 URL: https://mayddns.com/update/{uuid}
  • IPv6 URL: https://v6.mayddns.com/update/{uuid}
  • IP address is auto-detected from the request headers

Examples:

curl "https://mayddns.com/update/6f5fa996-daac-4070-9650-64fd30dcbe99"
wget -q -O- "https://v6.mayddns.com/update/6f5fa996-daac-4070-9650-64fd30dcbe99"

3. Return Codes

HTTP Status Codes

  • 200 — Success
  • 400 — Bad Request (invalid parameters)
  • 401 — Unauthorized (authentication failed)
  • 404 — Not Found (hostname / UUID not found)
  • 429 — Too Many Requests (rate limit exceeded)
  • 500 — Internal Server Error
  • 502 — Bad Gateway (DNS update failed)

Response Messages

  • good [IP] — Update successful
  • nochg [IP] — IP unchanged, no update needed
  • badauth — Authentication failed
  • nohost — Hostname parameter missing
  • badip — Invalid IP address
  • notfound — Hostname / UUID not found
  • noipv6 — IPv6 not supported for this record
  • dnserr — DNS update error
  • 911 — Internal server error
  • abuse — Rate limit exceeded

4. Rate Limit

Maximum 5 update requests per minute per IP address.