Dave's Ruby interface to the NFSN API

Yes, this page is ugly. I'm hacking code here, not building a corporate web "presence"! This page will change, especially during development!

Feel free to send me criticism, adoration, patches and comments. My email address is at the bottom of this page. The code is licensed under the GNU GPL.

What is it?

This is a Ruby module for accessing the NearlyFreeSpeech.NET API in a fairly Ruby-esque way. There is RDoc documentation available.

What you need

1. Ruby
2. The JSON ruby module
3. An API key
4. My code

1 and 2 are all available on the NFSN shell/CGI server, so you can just play with it there.
3 requires you to send a SSR (Secure Support Request).
4 is not a complete script, just a proof-of-concept.

Caveats/Pitfalls

• General
  • You'll need to modify the test code at the bottom of the script. Hopefully it should be pretty obvious what to do. If not, ask on the NFSN forums, or send me an email.
  • The SSL certificate is not verified, just ignored. This is obviously not all that secure.
  • Most of the API isn't implemented, so very few things will work. The DNS#minTTL property is one that does work, so try testing with that first. Site#addAlias(...) and Site#removeAlias(...) also work.
• Running externally
  • If you get errors that say The authentication timestamp is out of range, you should set up NTP on your computer because the clocks of the NFSN API server and your other computer need to be synchronised to within 5 seconds.