add post about rest api documentation
fixes after review. Now use a poney race as example
integrate remark from Cedric
Merge pull request #77 from Ninja-Squad/topic/restDoc

add post about rest api documentation