[API] Add query API docs

[nadouani]

Add documentation of the generic query APIs:

• describe the api structure
• describe filtering
• describe sorting
• describe pagination
• describe extra data options