update links to api doc
add key api and entity
add basic specs