Make sure examples types match schema in definitions (#1563)

* Make sure examples types match schema in definitions

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Add changelogs

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

* Add double quotes around URL

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

---------

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>

changelogs/client_server/newsfragments/1563.clarification

@@ -0,0 +1 @@
+Make sure examples types match schema in definitions.

changelogs/identity_service/newsfragments/1563.clarification

@@ -0,0 +1 @@
+Make sure examples types match schema in definitions.

changelogs/server_server/newsfragments/1563.clarification

@@ -0,0 +1 @@
+Make sure examples types match schema in definitions.

data/api/client-server/message_pagination.yaml

@@ -84,7 +84,7 @@ paths:
         - in: query
           name: limit
           description: "The maximum number of events to return. Default: 10."
-          example: "3"
+          example: 3
           schema:
             type: integer
         - in: query

data/api/client-server/old_sync.yaml

@@ -44,7 +44,7 @@ paths:
           name: timeout
           description: The maximum time in milliseconds to wait for an event.
           required: false
-          example: "35000"
+          example: 35000
           schema:
             type: integer
       responses:
@@ -105,7 +105,7 @@ paths:
           name: limit
           description: The maximum number of messages to return for each room.
           required: false
-          example: "2"
+          example: 2
           schema:
             type: integer
         - in: query
@@ -116,7 +116,7 @@ paths:
             included. If set to `true` then rooms that the user has left are
             included as well. By default this is `false`.
           required: false
-          example: "true"
+          example: true
           schema:
             type: boolean
       responses:

data/api/client-server/peeking_events.yaml

@@ -49,14 +49,13 @@ paths:
           name: timeout
           description: The maximum time in milliseconds to wait for an event.
           required: false
-          example: "35000"
+          example: 35000
           schema:
             type: integer
         - in: query
           name: room_id
           description: The room ID for which events should be returned.
-          example:
+          example: "!somewhere:over.the.rainbow"
-            - "!somewhere:over.the.rainbow"
           schema:
             type: string
       responses:

data/api/client-server/pushrules.yaml

@@ -543,7 +543,7 @@ paths:
           required: true
           description: |
             The kind of rule
-          example: cake
+          example: content
           schema:
             type: string
             enum:

data/api/client-server/sync.yaml

@@ -84,7 +84,7 @@ paths:
             changed since the point indicated by `since` will be returned.
 
             By default, this is `false`.
-          example: "false"
+          example: false
           schema:
             type: boolean
         - in: query

data/api/identity/v2_associations.yaml

@@ -29,7 +29,7 @@ paths:
           name: sid
           description: The Session ID generated by the `requestToken` call.
           required: true
-          example: 1234
+          example: "1234"
           schema:
             type: string
         - in: query

data/api/identity/v2_email_associations.yaml

@@ -186,7 +186,7 @@ paths:
           name: sid
           required: true
           description: The session ID, generated by the `requestToken` call.
-          example: 1234
+          example: "1234"
           schema:
             type: string
         - in: query

data/api/identity/v2_phone_associations.yaml

@@ -188,7 +188,7 @@ paths:
           name: sid
           required: true
           description: The session ID, generated by the `requestToken` call.
-          example: 1234
+          example: "1234"
           schema:
             type: string
         - in: query

data/api/identity/v2_terms.yaml

@@ -131,7 +131,7 @@ paths:
                   items:
                     type: string
                   description: The URLs the user is accepting in this request.
-                  example: https://example.org/somewhere/terms-2.0-en.html
+                  example: ["https://example.org/somewhere/terms-2.0-en.html"]
               required:
                 - user_accepts
       responses:

data/api/server-server/leaving-v2.yaml

@@ -109,7 +109,6 @@ paths:
                 - depth
                 - content
             example: {
-              "room_id": "!somewhere:example.org",
               "type": "m.room.member",
               "state_key": "@someone:example.org",
               "origin": "example.org",
@@ -117,7 +116,8 @@ paths:
               "sender": "@someone:example.org",
               "content": {
                   "membership": "leave"
-              }
+              },
+              "depth": 0
             }
         required: true
       responses: