Knowledge Base
Search the knowledge base
Possible OpenDNS responses to the dynamic IP update API
OpenDNS uses the DNS Update API from DynDNS, so all clients which support that API fully and work over SSL will work with OpenDNS accounts.
The URL to send updates is:
https://updates.opendns.com/nic/update?hostname=
OpenDNS uses the normal result codes, but a few of the responses mean slightly different things to OpenDNS, without breaking the API. Those few are documented below, for those interested.
You do not need to pay attention to these codes unless you are writing your own client and curious about specific OpenDNS interpretations. (We encourage developers to support OpenDNS as a service, and are happy to help.)
- badauth means that your credentials (OpenDNS username and/or password) are missing or invalid.
- nohost means the OpenDNS member has no network set to accept DDNS updates. (By spec, this response means that the DDNS hostname you are trying to update does not exist.)
- good means the update process was successful, and your network preferences are applied. This may also indicate that your IP has not changed since your last update, therefore no update was needed.
- !yours means the IP address provided is part of a larger netblock managed by another OpenDNS customer or the IP address is being used by someone else. Details... (By spec, this response means the hostname specified exists, but not under the username specified.)
- abuse means OpenDNS received more than one update per minute.
Updated: December 2, 2007
