I am a Programmer, what OpenDNS Developer Resources Exist?
OpenDNS appreciates the software development community and offers a number of resources to programmers, including specifications of some of our proprietary technology and full access to our Application Programmer's Interfaces (APIs).
Dynamic DNS Result Code Information for Developers
If you are a developer interested in writing your own Dynamic DNS updater client, this topic contains information pertinent to a successful implementation.
OpenDNS uses the DNS Update API from DynDNS to receive Dynamic DNS updates of IP addresses. All clients that support this API completely and communicate over SSL will properly update OpenDNS network IP address information.
Note: The URL to use to send an IP address update to OpenDNS is:
https://updates.opendns.com/nic/update?hostname=
OpenDNS uses the standard Dynamic DNS result codes, but OpenDNS has modified the use of a few of the responses to add key functionality. These modifications do not change or disrupt the API and the modified responses are detailed in the following table.
| Dynamic DNS Result Code |
OpenDNS Interpretation |
Use According to Specification |
| badauth |
Username and password credentials are invalid or do not match an existing OpenDNS account. |
The username and password pair do not match a real user. |
| nohost |
OpenDNS account specified does not have a network enabled for dynamic IP updates. Follow this link for more information. |
The hostname specified does not exist in this user account (or is not in the service specified in the system parameter). |
| good |
The update was successful or not needed (the IP address has not changed since last update). OpenDNS filtering and security settings are applied as configured on this network. |
The update was successful, and the hostname is now updated. |
| !yours |
The IP address provided is part of a larger block of addresses managed by another OpenDNS administrator or the IP address is being used by someone else. Please see Error Messages for more information. |
The hostname specified exists, but not under the username specified. |
| abuse |
OpenDNS received more than one update per minute for a set period of time. |
The hostname specified is blocked for update abuse. |
Links to Other OpenDNS Resources for Developers
OpenDNS supports open development by community members for PhishTank and DNS-O-Matic.
For specific information, follow the links associated with the OpenDNS service below.
PhishTank DNS-O-Matic
