[TASK] adding client tests
[TASK] adding resource test
[TASK] nailing down concrete resource test
[TASK] adding response implementation test case
[TASK] adding concrete response test
[DOC] adding some more doc to API interface