initial check in of http json api best practices