reverse_name: raise exception on error status

Check error code from farsightsec/wdns/pull/1

Also includes some cleanup and documentation.