update urls, tests
added JSON protocol documentation