Add profile API. Add error definition to definitions folder.

The tool used for validating swagger 2.0 schemata does not currently
support deep-nested definitions from other files. Until it does, keep
the definitions in a separate file each in a definitions folder. This
will be replaced with a definitions.yaml in the future.

api/client-server/v1/content-repo.yaml

@@ -2,7 +2,7 @@ swagger: '2.0'
 info:
   title: "Matrix Client-Server v1 Content Repository API"
   version: "1.0.0"
-host: matrix.org
+host: localhost:8008
 schemes:
   - https
 basePath: /_matrix/media/v1

api/client-server/v1/definitions/error.yaml

@@ -0,0 +1,7 @@
+type: object
+properties:
+  errcode:
+    type: string
+  error:
+    type: string
+required: ["errcode"]

api/client-server/v1/directory.yaml

@@ -2,7 +2,7 @@ swagger: '2.0'
 info:
   title: "Matrix Client-Server v1 Directory API"
   version: "1.0.0"
-host: matrix.org
+host: localhost:8008
 schemes:
   - https
   - http

api/client-server/v1/profile.yaml

@@ -0,0 +1,110 @@
+swagger: '2.0'
+info:
+  title: "Matrix Client-Server v1 Profile API"
+  version: "1.0.0"
+host: localhost:8008
+schemes:
+  - https
+  - http
+basePath: /_matrix/client/api/v1/profile
+consumes:
+  - application/json
+produces:
+  - application/json
+securityDefinitions:
+  accessToken:
+    type: apiKey
+    description: The user_id or application service access_token
+    name: access_token
+    in: query
+paths:
+  "/{userId}/displayname":
+    put:
+      summary: Set the user's display name.
+      security:
+        - accessToken: []
+      parameters:
+        - in: path
+          type: string
+          name: userId
+          description: The user whose display name to set.
+          required: true
+        - in: body
+          name: displayName
+          description: The display name info.
+          required: true
+          schema:
+            type: object
+            properties:
+              displayname:
+                type: string
+                description: The new display name for this user.
+      responses:
+        200:
+          description: The display name was set.
+          schema:
+            type: object  # empty json object
+    get:
+      summary: Get the user's display name.
+      parameters:
+        - in: path
+          type: string
+          name: userId
+          description: The user whose display name to get.
+          required: true
+      responses:
+        200:
+          description: The display name for this user.
+          schema:
+            type: object
+            properties:
+              displayname:
+                type: string
+                description: The user's display name if they have set one.
+        404:
+          description: There is no display name for this user or this user does not exist.
+  "/{userId}/avatar_url":
+    put:
+      summary: Set the user's avatar URL.
+      security:
+        - accessToken: []
+      parameters:
+        - in: path
+          type: string
+          name: userId
+          description: The user whose avatar URL to set.
+          required: true
+        - in: body
+          name: avatar_url
+          description: The avatar url info.
+          required: true
+          schema:
+            type: object
+            properties:
+              avatar_url:
+                type: string
+                description: The new avatar URL for this user.
+      responses:
+        200:
+          description: The avatar URL was set.
+          schema:
+            type: object  # empty json object
+    get:
+      summary: Get the user's avatar URL.
+      parameters:
+        - in: path
+          type: string
+          name: userId
+          description: The user whose avatar URL to get.
+          required: true
+      responses:
+        200:
+          description: The avatar URL for this user.
+          schema:
+            type: object
+            properties:
+              avatar_url:
+                type: string
+                description: The user's avatar URL if they have set one.
+        404:
+          description: There is no avatar URL for this user or this user does not exist.