RFC: Added query api to rest_api.md

Not sure what the url should be for list free nodes, open for
discussion.

Hopefully it's clear what all this actually means.