refactor HTTPAPI GET /clients spec a bit