add spec for pagination
rename header template
define datetimespec
specify not yet implemented apis in the client
check server requirements in the client