Node API updates. Changed location of the profile editing page.

Author: smelamud

_data/node_api.yml

@@ -854,6 +854,17 @@ objects:
         errors:
           - code: limit.invalid
             description: <code>limit</code> parameter has an invalid value
+      - url: /people/contacts/fetch
+        type: POST
+        function: fetchContacts
+        in:
+          struct: ContactFilter
+          name: filter
+        out:
+          struct: ContactWithRelationships
+          array: true
+        auth: admin
+        description: Fetch the detailed information, including relationships, about the contacts matching the filter.
   - name: Credentials
     description: Credentials used to authenticate the administrator of the node.
     requests:
@@ -1273,7 +1284,8 @@ objects:
       <ul>
         <li><code>timeline</code> - the main feed of publications;</li>
         <li><code>instant</code> - the feed of instant notifications;</li>
-        <li><code>news</code> - the main feed of publications gathered from other nodes.</li>
+        <li><code>news</code> - the main feed of publications gathered from other nodes;</li>
+        <li><code>explore</code> - the feed of recommended publications from around the network.</li>
       </ul>
     requests:
       - url: /feeds
@@ -2554,6 +2566,12 @@ objects:
         type: GET
         function: getRecommendedPostings
         query:
+          - type: String
+            name: feed
+            optional: true
+            description: >
+              name of the feed to get recommendations for ("news" by default); recommendations for every feed are
+              tracked separately
           - type: String
             name: sheriff
             optional: true
@@ -2638,6 +2656,13 @@ objects:
           - type: String
             name: postingId
             description: ID of the posting on the remote node
+        query:
+          - type: String
+            name: feed
+            optional: true
+            description: >
+              name of the feed the recommendation is accepted to ("news" by default); recommendations for every feed are
+              tracked separately
         out:
           struct: Result
         auth: required
@@ -2655,6 +2680,13 @@ objects:
           - type: String
             name: postingId
             description: ID of the posting on the remote node
+        query:
+          - type: String
+            name: feed
+            optional: true
+            description: >
+              name of the feed the recommendation is rejected for ("news" by default); recommendations for every feed
+              are tracked separately
         out:
           struct: Result
         auth: required
@@ -4849,6 +4881,12 @@ structures:
       - type: int
         name: total
         description: total number of comments in the posting after the operation
+  - name: ContactFilter
+    fields:
+      - type: String
+        array: true
+        name: nodeNames
+        description: list of node names to fetch
   - name: ContactInfo
     fields:
       - type: String
@@ -4903,6 +4941,37 @@ structures:
         name: adminOperations
         optional: true
         description: the operations and the corresponding principals that are overridden by the node administrator
+  - name: ContactWithRelationships
+    fields:
+      - struct: ContactInfo
+        name: contact
+        description: contact's details
+      - struct: SubscriberInfo
+        name: subscriber
+        optional: true
+        description: information about the contact's subscription to the node's feeds
+      - struct: SubscriptionInfo
+        name: subscription
+        optional: true
+        description: information about the nodes's subscription to the contact's feeds
+      - struct: FriendInfo
+        name: friend
+        optional: true
+        description: information about the node's friendship with the contact
+      - struct: FriendOfInfo
+        name: friendOf
+        optional: true
+        description: information about the contact's friendship with the node
+      - struct: BlockedUserInfo
+        array: true
+        name: blocked
+        optional: true
+        description: information about blocking the contact by the node
+      - struct: BlockedByUserInfo
+        array: true
+        name: blockedBy
+        optional: true
+        description: information about blocking the node by the contact
   - name: Credentials
     fields:
       - type: String

_data/py_node_api.yml

@@ -1468,6 +1468,16 @@ objects:
       name: limit
       optional: true
       type: int
+  - auth: admin
+    description: Fetch the detailed information, including relationships, about the
+      contacts matching the filter.
+    function: fetch_contacts(filter)
+    out:
+      array: true
+      struct: ContactWithRelationships
+    params:
+    - name: filter
+      struct: ContactFilter
 - description: Credentials used to authenticate the administrator of the node.
   name: Credentials
   requests:
@@ -1870,7 +1880,8 @@ objects:
     \ the standard feeds that have special meaning: <ul>\n  <li><code>timeline</code>\
     \ - the main feed of publications;</li>\n  <li><code>instant</code> - the feed\
     \ of instant notifications;</li>\n  <li><code>news</code> - the main feed of publications\
-    \ gathered from other nodes.</li>\n</ul>\n"
+    \ gathered from other nodes;</li>\n  <li><code>explore</code> - the feed of recommended\
+    \ publications from around the network.</li>\n</ul>\n"
   name: Feeds
   requests:
   - auth: admin or none
@@ -3010,11 +3021,18 @@ objects:
       description: <code>limit</code> parameter has an invalid value
     - code: sheriff.not-found
       description: sheriff node is not registered
-    function: get_recommended_postings(sheriff=None, limit=None)
+    function: get_recommended_postings(feed=None, sheriff=None, limit=None)
     out:
       array: true
       struct: RecommendedPostingInfo
     params:
+    - description: 'name of the feed to get recommendations for ("news" by default);
+        recommendations for every feed are tracked separately
+
+        '
+      name: feed
+      optional: true
+      type: str
     - description: filter out entries prohibited by the given sheriff
       name: sheriff
       optional: true
@@ -3079,7 +3097,7 @@ objects:
     errors:
     - code: not-found
       description: the posting is not found
-    function: accept_recommended_posting(node_name, posting_id)
+    function: accept_recommended_posting(node_name, posting_id, feed=None)
     out:
       struct: Result
     params:
@@ -3089,13 +3107,20 @@ objects:
     - description: ID of the posting on the remote node
       name: posting_id
       type: str
+    - description: 'name of the feed the recommendation is accepted to ("news" by
+        default); recommendations for every feed are tracked separately
+
+        '
+      name: feed
+      optional: true
+      type: str
   - auth: required
     description: Inform the recommendation service that the recommended posting was
       rejected by the client.
     errors:
     - code: not-found
       description: the posting is not found
-    function: reject_recommended_posting(node_name, posting_id)
+    function: reject_recommended_posting(node_name, posting_id, feed=None)
     out:
       struct: Result
     params:
@@ -3105,6 +3130,13 @@ objects:
     - description: ID of the posting on the remote node
       name: posting_id
       type: str
+    - description: 'name of the feed the recommendation is rejected for ("news" by
+        default); recommendations for every feed are tracked separately
+
+        '
+      name: feed
+      optional: true
+      type: str
   - auth: required
     description: 'Ask the recommendation service to exclude all content from the given
       node from future recommendations.
@@ -5526,6 +5558,12 @@ structures:
     name: total
     type: int
   name: CommentTotalInfo
+- fields:
+  - array: true
+    description: list of node names to fetch
+    name: node_names
+    type: str
+  name: ContactFilter
 - fields:
   - name: node_name
     type: str
@@ -5583,6 +5621,37 @@ structures:
     optional: true
     struct: ContactOperations
   name: ContactInfo
+- fields:
+  - description: contact's details
+    name: contact
+    struct: ContactInfo
+  - description: information about the contact's subscription to the node's feeds
+    name: subscriber
+    optional: true
+    struct: SubscriberInfo
+  - description: information about the nodes's subscription to the contact's feeds
+    name: subscription
+    optional: true
+    struct: SubscriptionInfo
+  - description: information about the node's friendship with the contact
+    name: friend
+    optional: true
+    struct: FriendInfo
+  - description: information about the contact's friendship with the node
+    name: friend_of
+    optional: true
+    struct: FriendOfInfo
+  - array: true
+    description: information about blocking the contact by the node
+    name: blocked
+    optional: true
+    struct: BlockedUserInfo
+  - array: true
+    description: information about blocking the node by the contact
+    name: blocked_by
+    optional: true
+    struct: BlockedByUserInfo
+  name: ContactWithRelationships
 - fields:
   - constraints:
     - notblank: