3 * @copyright Copyright (C) 2010-2021, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Module\Api\Twitter\Followers;
24 use Friendica\Core\System;
25 use Friendica\Database\DBA;
26 use Friendica\Module\Api\Twitter\ContactEndpoint;
27 use Friendica\Module\BaseApi;
30 * @see https://developer.twitter.com/en/docs/accounts-and-users/follow-search-get-users/api-reference/get-followers-ids
32 class Ids extends ContactEndpoint
34 protected function rawContent(array $request = [])
36 self::checkAllowedScope(self::SCOPE_READ);
37 $uid = BaseApi::getCurrentUserID();
39 // Expected value for user_id parameter: public/user contact id
40 $contact_id = filter_input(INPUT_GET, 'user_id' , FILTER_VALIDATE_INT);
41 $screen_name = filter_input(INPUT_GET, 'screen_name');
42 $profile_url = filter_input(INPUT_GET, 'profile_url');
43 $cursor = filter_input(INPUT_GET, 'cursor' , FILTER_VALIDATE_INT, ['options' => ['default' => -1]]);
44 $stringify_ids = filter_input(INPUT_GET, 'stringify_ids', FILTER_VALIDATE_BOOLEAN, ['options' => ['default' => false]]);
45 $count = filter_input(INPUT_GET, 'count' , FILTER_VALIDATE_INT, ['options' => [
46 'default' => self::DEFAULT_COUNT,
48 'max_range' => self::MAX_COUNT,
51 $since_id = filter_input(INPUT_GET, 'since_id' , FILTER_VALIDATE_INT);
52 $max_id = filter_input(INPUT_GET, 'max_id' , FILTER_VALIDATE_INT);
53 $min_id = filter_input(INPUT_GET, 'min_id' , FILTER_VALIDATE_INT);
55 $cid = BaseApi::getContactIDForSearchterm($screen_name, $profile_url, $contact_id, $uid);
57 $params = ['order' => ['relation-cid' => true], 'limit' => $count];
59 $condition = ['cid' => $cid, 'follows' => true];
61 $total_count = (int)DBA::count('contact-relation', $condition);
63 if (!empty($max_id)) {
64 $condition = DBA::mergeConditions($condition, ["`relation-cid` < ?", $max_id]);
67 if (!empty($since_id)) {
68 $condition = DBA::mergeConditions($condition, ["`relation-cid` > ?", $since_id]);
71 if (!empty($min_id)) {
72 $condition = DBA::mergeConditions($condition, ["`relation-cid` > ?", $min_id]);
74 $params['order'] = ['relation-cid'];
79 $followers = DBA::select('contact-relation', ['relation-cid'], $condition, $params);
80 while ($follower = DBA::fetch($followers)) {
81 self::setBoundaries($follower['relation-cid']);
82 $ids[] = $follower['relation-cid'];
84 DBA::close($followers);
86 if (!empty($min_id)) {
87 $ids = array_reverse($ids);
90 $return = self::ids($ids, $total_count, $cursor, $count, $stringify_ids);
92 self::setLinkHeader();
94 System::jsonExit($return);