|DataResponse * * 200: Authentication credentials returned * 412: Getting authentication credentials is not possible */ #[OpenAPI(scope: OpenAPI::SCOPE_IGNORE)] #[PublicPage] #[ApiRoute(verb: 'POST', url: '/api/{apiVersion}/hostedsignalingserver/auth', requirements: [ 'apiVersion' => '(v1)', ])] public function auth(): DataResponse { $storedNonce = $this->config->getAppValue('spreed', 'hosted-signaling-server-nonce', ''); // reset nonce after one request $this->config->deleteAppValue('spreed', 'hosted-signaling-server-nonce'); if ($storedNonce !== '') { return new DataResponse([ 'nonce' => $storedNonce, ]); } return new DataResponse(null, Http::STATUS_PRECONDITION_FAILED); } /** * Request a trial account * * @param string $url Server URL * @param string $name Display name of the user * @param string $email Email of the user * @param string $language Language of the user * @param string $country Country of the user * @return DataResponse, array{}>|DataResponse * * 200: Trial requested successfully * 400: Requesting trial is not possible */ #[ApiRoute(verb: 'POST', url: '/api/{apiVersion}/hostedsignalingserver/requesttrial', requirements: [ 'apiVersion' => '(v1)', ])] public function requestTrial(string $url, string $name, string $email, string $language, string $country): DataResponse { try { $registerAccountData = new RegisterAccountData( $url, $name, $email, $language, $country ); $accountId = $this->hostedSignalingServerService->registerAccount($registerAccountData); $accountInfo = $this->hostedSignalingServerService->fetchAccountInfo($accountId); $this->config->setAppValue('spreed', 'hosted-signaling-server-account', json_encode($accountInfo)); } catch (HostedSignalingServerAPIException $e) { // API or connection issues return new DataResponse(['message' => $e->getMessage()], Http::STATUS_INTERNAL_SERVER_ERROR); } catch (HostedSignalingServerInputException $e) { // user solvable issues return new DataResponse(['message' => $e->getMessage()], Http::STATUS_BAD_REQUEST); } return new DataResponse($accountInfo); } /** * Delete the account * * @return DataResponse|DataResponse * * 204: Account deleted successfully * 400: Deleting account is not possible */ #[ApiRoute(verb: 'DELETE', url: '/api/{apiVersion}/hostedsignalingserver/delete', requirements: [ 'apiVersion' => '(v1)', ])] public function deleteAccount(): DataResponse { $accountId = $this->config->getAppValue('spreed', 'hosted-signaling-server-account-id'); if ($accountId === null) { return new DataResponse(['message' => $this->l10n->t('No account available to delete.')], Http::STATUS_BAD_REQUEST); } try { $this->hostedSignalingServerService->deleteAccount(new AccountId($accountId)); } catch (HostedSignalingServerAPIException $e) { if ($e->getCode() === Http::STATUS_NOT_FOUND) { // Account was deleted, so remove the information locally } elseif ($e->getCode() === Http::STATUS_UNAUTHORIZED) { // Account is expired and deletion is pending unless it's reactivated. } else { // API or connection issues - do nothing and just try again later return new DataResponse(['message' => $e->getMessage()], Http::STATUS_INTERNAL_SERVER_ERROR); } } $this->config->deleteAppValue('spreed', 'hosted-signaling-server-account'); $this->config->deleteAppValue('spreed', 'hosted-signaling-server-account-id'); // remove signaling servers if account is not active anymore $this->config->deleteAppValue('spreed', 'signaling_mode'); $this->config->deleteAppValue('spreed', 'signaling_servers'); $this->logger->info('Deleted hosted signaling server account with ID ' . $accountId); return new DataResponse(null, Http::STATUS_NO_CONTENT); } }