people.rb 1.44 KB
module Noosfero
  module API
    module V1
      class People < Grape::API
        before { authenticate! }
  
        resource :people do
  
          # Collect comments from articles
          #
          # Parameters:
          #   from             - date where the search will begin. If nothing is passed the default date will be the date of the first article created
          #   oldest           - Collect the oldest comments from reference_id comment. If nothing is passed the newest comments are collected
          #   limit            - amount of comments returned. The default value is 20
          #
          # Example Request:
          #  GET /people?from=2013-04-04-14:41:43&until=2014-04-04-14:41:43&limit=10
          #  GET /people?reference_id=10&limit=10&oldest
          get do
            people = select_filtered_collection_of(environment, 'people', params)
            people = people.visible_for_person(current_person)
            present people, :with => Entities::Person
          end
  
          desc "Return the person information"
          get ':id' do
            person = environment.people.visible.find_by_id(params[:id])
            present person, :with => Entities::Person
          end
  
          desc "Return the person friends"
          get ':id/friends' do
            friends = current_person.friends.visible
            present friends, :with => Entities::Person
          end
  
        end
  
      end
    end
  end
end