class GdsApi::NeedApi

def close(need_id, duplicate_of)
  # duplicate_of is a hash of the required fields for closing
  # a need as a duplicate: { "duplicate_of" => 100001,
  #                          "author" => { ... }
  #                        }
  put_json!("#{endpoint}/needs/#{CGI.escape(need_id.to_s)}/closed", duplicate_of)
end

def create_need(need)
  post_json!("#{endpoint}/needs", need)
end

def create_note(note)
  post_json!("#{endpoint}/notes", note)
end

def need(need_id)
  get_json("#{endpoint}/needs/#{CGI.escape(need_id.to_s)}")
end

def needs(options = {})
  query = query_string(options)
  get_list!("#{endpoint}/needs#{query}")
end

def needs_by_id(*ids)
  ids_string = ids.flatten.map(&:to_i).sort.join(',')
  query = query_string(ids: ids_string)
  get_list!("#{endpoint}/needs#{query}")
end

def organisations
  get_json!("#{endpoint}/organisations")["organisations"]
end

def reopen(need_id, author)
  # author params: { "author" => { ... } }"
  delete_json!("#{endpoint}/needs/#{CGI.escape(need_id.to_s)}/closed", author)
end

def update_need(need_id, need_update)
  # `need_update` can be a hash of updated fields or a complete need
  put_json!("#{endpoint}/needs/#{CGI.escape(need_id.to_s)}", need_update)
end