improve(auth): docs and api

- improve api & docs in authorization service

releated to #CAM-960
fix(auth): write proper SQL

related to #CAM-979