add api endpoint for listing calendars

src/Bundle/ChillCalendarBundle/chill.api.specs.yaml

@@ -95,7 +95,43 @@ paths:
                     description: "ok"
                 404:
                     description: "not found"
-                401:
+                403:
+                    description: "Unauthorized"
+
+    /1.0/calendar/calendar/by-user/{userId}.json:
+        get:
+            tags:
+                - calendar
+            summary: Return a list of calendars for a user
+            parameters:
+                -   name: userId
+                    in: path
+                    required: true
+                    description: The user id
+                    schema:
+                        type: integer
+                        format: integer
+                        minimum: 1
+                -   name: dateFrom
+                    in: query
+                    required: true
+                    description: The date from, formatted as ISO8601 string
+                    schema:
+                        type: string
+                        format: date-time
+                -   name: dateTo
+                    in: query
+                    required: true
+                    description: The date to, formatted as ISO8601 string
+                    schema:
+                        type: string
+                        format: date-time
+            responses:
+                200:
+                    description: "ok"
+                404:
+                    description: "not found"
+                403:
                     description: "Unauthorized"
 
     /1.0/calendar/calendar-range.json: