Do your GET request at http://www.dorpinator.nl/api/. This will dorpinate into JSON.
This JSON will contain the following data:
| backgroundimage | Link to a background image |
| backgroundimageauthor | Link to license and author information about background image |
| town | A dorpinated town |
| province | A dorpinated province |
You are required to provide the link below when presenting output of this API in your application:
| Link | HTML |
| Powered by Dorpinator.nl |
<a href="http://www.dorpinator.nl/">Powered by Dorpinator.nl</a>
|
You are probably also required to provide credit to the photographer, when using the photograph in backgroundimage. Use backgroundimageauthor to acquire information about the author.
Your application should not do more than a request per second, primarily because I have no idea what sort of performance the underlying infrastructure is capable of. I am uninterested in finding out the hard way.
If the API proves popular, API keys will be enabled and API 1.0 will be deprecated. Drop a line at
tehdorpinatorapiborrehnl if you'd like to be kept in the loop about this.