Add address suggestion for a person

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

@@ -354,10 +354,35 @@ paths:
           description: "OK"
         422:
           description: "Unprocessable entity (validation errors)"
-        400:
-          description: "transition cannot be applyed"
 
 
+  /1.0/person/address/suggest/by-person/{id}.json:
+    get:
+      tags:
+        - address
+      summary: get a list of suggested address for a person
+      description: >
+          The address are computed from various source. Currently:
+
+          - the address of course to which the person is participating
+
+          The current person's address is always ignored.
+      parameters:
+        - name: id
+          in: path
+          required: true
+          description: The person id
+          schema:
+            type: integer
+            format: integer
+            minimum: 1
+      responses:
+        401:
+          description: "Unauthorized"
+        404:
+          description: "Not found"
+        200:
+          description: "OK"
 
   /1.0/person/accompanying-course/{id}.json:
     get: