3 * @copyright Copyright (C) 2010-2023, 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\Mastodon;
26 use Friendica\Core\Config\Capability\IManageConfigValues;
27 use Friendica\Core\L10n;
28 use Friendica\Core\System;
29 use Friendica\Database\Database;
31 use Friendica\Model\User;
32 use Friendica\Module\Api\ApiResponse;
33 use Friendica\Module\BaseApi;
34 use Friendica\Module\Register;
35 use Friendica\Object\Api\Mastodon\InstanceV2 as InstanceEntity;
36 use Friendica\Util\Images;
37 use Friendica\Util\Profiler;
38 use Friendica\Util\Strings;
39 use Psr\Log\LoggerInterface;
42 * @see https://docs.joinmastodon.org/methods/instance/
44 class InstanceV2 extends BaseApi
49 /** @var IManageConfigValues */
52 public function __construct(
57 LoggerInterface $logger,
59 ApiResponse $response,
61 IManageConfigValues $config,
63 array $parameters = []
65 parent::__construct($app, $l10n, $baseUrl, $args, $logger, $profiler, $response, $server, $parameters);
67 $this->database = $database;
68 $this->config = $config;
72 * @param array $request
73 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
74 * @throws \Friendica\Network\HTTPException\NotFoundException
75 * @throws \ImagickException
78 protected function rawContent(array $request = [])
80 $domain = $this->baseUrl->getHost();
81 $title = $this->config->get('config', 'sitename');
82 $version = '2.8.0 (compatible; Friendica ' . App::VERSION . ')';
83 $description = $this->config->get('config', 'info');
84 $usage = $this->buildUsageInfo();
85 $thumbnail = new InstanceEntity\Thumbnail($this->baseUrl->withPath('images/friendica-banner.jpg'));
86 $languages = [$this->config->get('system', 'language')];
87 $configuration = $this->buildConfigurationInfo();
88 $registration = $this->buildRegistrationsInfo();
89 $contact = $this->buildContactInfo();
90 $friendica_extensions = $this->buildFriendicaExtensionInfo();
91 $rules = System::getRules();
92 System::jsonExit(new InstanceEntity(
103 $friendica_extensions,
108 private function buildConfigurationInfo(): InstanceEntity\Configuration
110 $statuses_config = new InstanceEntity\StatusesConfig((int)$this->config->get(
113 $this->config->get('config', 'max_import_size')
116 $image_size_limit = Strings::getBytesFromShorthand($this->config->get('system', 'maximagesize'));
118 return new InstanceEntity\Configuration(
120 new InstanceEntity\MediaAttachmentsConfig(Images::supportedTypes(), $image_size_limit),
124 private function buildContactInfo(): InstanceEntity\Contact
126 $email = implode(',', User::getAdminEmailList());
127 $administrator = User::getFirstAdmin();
130 if ($administrator) {
131 $adminContact = $this->database->selectFirst(
134 ['nick' => $administrator['nickname'], 'self' => true]
136 $account = DI::mstdnAccount()->createFromUriId($adminContact['uri-id']);
139 return new InstanceEntity\Contact($email, $account);
142 private function buildFriendicaExtensionInfo(): InstanceEntity\FriendicaExtensions
144 return new InstanceEntity\FriendicaExtensions(
147 $this->config->get('system', 'build')
151 private function buildRegistrationsInfo(): InstanceEntity\Registrations
153 $register_policy = intval($this->config->get('config', 'register_policy'));
154 $enabled = ($register_policy != Register::CLOSED);
155 $approval_required = ($register_policy == Register::APPROVE);
157 return new InstanceEntity\Registrations($enabled, $approval_required);
160 private function buildUsageInfo(): InstanceEntity\Usage
162 if (!empty($this->config->get('system', 'nodeinfo'))) {
163 $active_monthly = intval(DI::keyValue()->get('nodeinfo_active_users_monthly'));
168 return new InstanceEntity\Usage(new InstanceEntity\UserStats($active_monthly));