VMware today released the following guide which provides guidance and examples for leveraging the NSX REST API.

The guide can be downloaded here https://communities.vmware.com/docs/DOC-31921