/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

package org.apache.streams.twitter.api;

import org.apache.streams.twitter.pojo.Tweet;

import org.apache.juneau.remoteable.QueryIfNE;
import org.apache.juneau.remoteable.RemoteMethod;
import org.apache.juneau.remoteable.Remoteable;

import java.util.List;

/**
 * Interface for /followers methods.
 *
 * @see <a href="https://dev.twitter.com/rest/reference">https://dev.twitter.com/rest/reference</a>
 */
@Remoteable(path = "https://api.twitter.com/1.1/followers")
public interface Followers {

  /**
   * Returns a cursored collection of user IDs for every user following the specified user.
   *
   * @param parameters {@link org.apache.streams.twitter.api.FollowersIdsRequest}
   * @return FollowersIdsResponse
   * @see <a href="https://dev.twitter.com/rest/reference/get/followers/ids">https://dev.twitter.com/rest/reference/get/followers/ids</a>
   *
   */
  @RemoteMethod(httpMethod = "GET", path = "/ids.json")
  public FollowersIdsResponse ids( @QueryIfNE("*") FollowersIdsRequest parameters);

  /**
   * Returns a cursored collection of user objects for users following the specified user.
   *
   * @param parameters {@link org.apache.streams.twitter.api.FollowersListRequest}
   * @return FollowersListResponse
   * @see <a href="https://dev.twitter.com/rest/reference/get/followers/list">https://dev.twitter.com/rest/reference/get/followers/list</a>
   *
   */
  @RemoteMethod(httpMethod = "GET", path = "/list.json")
  public FollowersListResponse list( @QueryIfNE("*") FollowersListRequest parameters);

}

@@ -1062,32 +1062,38 @@
 ref=%22https://dev
+eloper
 .twitter.com/res
@@ -1081,37 +1081,87 @@
 per.twitter.com/
-rest/
+en/docs/accounts-and-users/follow-search-get-users/api-
 reference%22%3Ehttps
@@ -1158,32 +1158,38 @@
 nce%22%3Ehttps://dev
+eloper
 .twitter.com/res
@@ -1177,37 +1177,87 @@
 per.twitter.com/
-rest/
+en/docs/accounts-and-users/follow-search-get-users/api-
 reference%3C/a%3E%0A *
@@ -1589,32 +1589,38 @@
 ref=%22https://dev
+eloper
 .twitter.com/res
@@ -1608,37 +1608,87 @@
 per.twitter.com/
-rest/
+en/docs/accounts-and-users/follow-search-get-users/api-
 reference/get/fo
@@ -1676,33 +1676,33 @@
 pi-reference/get
-/
+-
 followers/ids%22%3Eh
@@ -1694,17 +1694,17 @@
 ollowers
-/
+-
 ids%22%3Ehtt
@@ -1703,32 +1703,38 @@
 ids%22%3Ehttps://dev
+eloper
 .twitter.com/res
@@ -1722,37 +1722,87 @@
 per.twitter.com/
-rest/
+en/docs/accounts-and-users/follow-search-get-users/api-
 reference/get/fo
@@ -1790,33 +1790,33 @@
 pi-reference/get
-/
+-
 followers/ids%3C/a
@@ -1808,17 +1808,17 @@
 ollowers
-/
+-
 ids%3C/a%3E%0A
@@ -2211,32 +2211,38 @@
 ref=%22https://dev
+eloper
 .twitter.com/res
@@ -2230,37 +2230,87 @@
 per.twitter.com/
-rest/
+en/docs/accounts-and-users/follow-search-get-users/api-
 reference/get/fo
@@ -2298,33 +2298,33 @@
 pi-reference/get
-/
+-
 followers/list%22%3E
@@ -2312,25 +2312,25 @@
 et-followers
-/
+-
 list%22%3Ehttps:
@@ -2334,16 +2334,22 @@
 ps://dev
+eloper
 .twitter
@@ -2357,13 +2357,63 @@
 com/
-rest/
+en/docs/accounts-and-users/follow-search-get-users/api-
 refe
@@ -2421,17 +2421,17 @@
 ence/get
-/
+-
 follower
@@ -2431,17 +2431,17 @@
 ollowers
-/
+-
 list%3C/a%3E

update followers endpoint