bitPickups/friendica_2020-09-1_sharedHosting
1
0
Fork 0
Code Pull requests Activity

API: Added endpoints /instance and /instance/peers

Browse source
This commit is contained in:
Michael 2019-12-10 21:27:09 +00:00
parent 9c1f652008
commit 1958bde4c0
4 changed files with 119 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
doc/API-Mastodon.md
View file

@ -16,6 +16,8 @@ These endpoints use the [Mastodon API entities](https://docs.joinmastodon.org/ap
## Implemented endpoints
- [GET /api/v1/follow_requests](https://docs.joinmastodon.org/api/rest/follow-requests/#get-api-v1-follow-requests)
- [GET /api/v1/instance](https://docs.joinmastodon.org/api/rest/instances)
- GET /api/v1/instance/peers - undocumented, but implemented by Mastodon and Pleroma
## Non-implemented endpoints

74
src/Module/Api/Mastodon/Instance.php Normal file
View file

@ -0,0 +1,74 @@
<?php
namespace Friendica\Module\Api\Mastodon;
use Friendica\Core\Config;
use Friendica\Core\Protocol;
use Friendica\Core\System;
use Friendica\Database\DBA;
use Friendica\Model\User;
use Friendica\Module\Base\Api;
use Friendica\Module\Register;
use Friendica\Network\HTTPException;
use Friendica\Util\Network;
/**
* @see https://docs.joinmastodon.org/api/rest/instances/
*/
class Instance extends Api
{
public static function init(array $parameters = [])
{
parent::init($parameters);
}
/**
* @param array $parameters
* @throws HTTPException\InternalServerErrorException
*/
public static function rawContent(array $parameters = [])
{
$app = self::getApp();
$register_policy = intval(Config::get('config', 'register_policy'));
$return = [
'uri' => $app->getBaseURL(),
'title' => Config::get('config', 'sitename'),
'short_description' => '', // Not supported
'description' => Config::get('config', 'info'),
'email' => Config::get('config', 'admin_email'),
'version' => FRIENDICA_VERSION,
'urls' => [], // Not supported
'stats' => [],
'thumbnail' => $app->getBaseURL() . (Config::get('system', 'shortcut_icon') ?? 'images/friendica-32.png'),
'languages' => [Config::get('system', 'language')],
'registrations' => ($register_policy != Register::CLOSED),
'approval_required' => ($register_policy == Register::APPROVE),
'contact_account' => [] // Currently unsupported
];
if (!empty(Config::get('system', 'nodeinfo'))) {
$count = DBA::count('gserver', ["`network` in (?, ?) AND `last_contact` >= `last_failure`", Protocol::DFRN, Protocol::ACTIVITYPUB]);
$return['stats'] = [
'user_count' => intval(Config::get('nodeinfo', 'total_users')),
'status_count' => Config::get('nodeinfo', 'local_posts') + Config::get('nodeinfo', 'local_comments'),
'domain_count' => $count
];
}
/// @ToDo will be done, once that we have an API function for that
/*
if (!empty(Config::get('config', 'admin_email'))) {
$adminList = explode(',', str_replace(' ', '', Config::get('config', 'admin_email')));
$administrator = User::getByEmail($adminList[0], ['nickname']);
if (!empty($administrator)) {
$adminContact = DBA::selectFirst('contact', [], ['nick' => $administrator['nickname'], 'self' => true]);
$return['contact_account'] = Api::getAccountArray($adminContact);
}
}
*/
System::jsonExit($return);
}
}

41
src/Module/Api/Mastodon/Instance/Peers.php Normal file
View file

@ -0,0 +1,41 @@
<?php
namespace Friendica\Module\Api\Mastodon\Instance;
use Friendica\Core\Protocol;
use Friendica\Core\System;
use Friendica\Database\DBA;
use Friendica\Module\Base\Api;
use Friendica\Network\HTTPException;
use Friendica\Util\Network;
/**
* Undocumented API endpoint that is implemented by both Mastodon and Pleroma
*/
class Peers extends Api
{
public static function init(array $parameters = [])
{
parent::init($parameters);
}
/**
* @param array $parameters
* @throws HTTPException\InternalServerErrorException
*/
public static function rawContent(array $parameters = [])
{
$return = [];
// We only select for Friendica and ActivityPub servers, since it is expected to only deliver AP compatible systems here.
$instances = DBA::select('gserver', ['url'], ["`network` in (?, ?) AND `last_contact` >= `last_failure`", Protocol::DFRN, Protocol::ACTIVITYPUB]);
while ($instance = DBA::fetch($instances)) {
$urldata = parse_url($instance['url']);
unset($urldata['scheme']);
$return[] = ltrim(Network::unparseURL($urldata), '/');
}
DBA::close($instances);
System::jsonExit($return);
}
}

2
static/routes.config.php
View file

@ -30,6 +30,8 @@ return [
'/api' => [
'/v1' => [
'/follow_requests' => [Module\Api\Mastodon\FollowRequests::class, [R::GET ]],
'/instance' => [Module\Api\Mastodon\Instance::class, [R::GET]],
'/instance/peers' => [Module\Api\Mastodon\Instance\Peers::class, [R::GET]],
],
],