. */ namespace API; use Carbon\Carbon; use GuzzleHttp\Client; use Models\Cache; /** * Classe per l'interazione con API esterne. * * @since 2.4.3 */ class Services { protected static $client = null; /** * Controlla se il gestionale ha accesso a Services. * * @return bool */ public static function isEnabled() { return !empty(setting('OSMCloud Services API Token')); } /** * Restituisce le informazioni disponibili su Services. * * @return array */ public static function getInformazioni($force = false) { $cache = Cache::pool('Informazioni su Services'); // Aggiornamento dei contenuti della cache if (!$cache->isValid() || $force) { $response = self::request('GET', 'info'); $content = self::responseBody($response); $cache->set($content); return $content; } return $cache->content; } /** * Restituisce i servizi attivi attraverso Services. * * @return \Illuminate\Support\Collection */ public static function getServiziAttivi() { return collect(self::getInformazioni()['servizi']); } /** * Restituisce i servizi in scadenza per data di conclusione prossima. * * @param Carbon $limite_scadenze * * @return \Illuminate\Support\Collection */ public static function getServiziInScadenza($limite_scadenze) { return self::getServiziAttivi() ->flatten(1) ->filter(function ($item) use ($limite_scadenze) { return isset($item['data_conclusione']) && Carbon::parse($item['data_conclusione'])->lessThan($limite_scadenze); }); } /** * Restituisce le risorse attive in Services. * * @return \Illuminate\Support\Collection */ public static function getRisorseAttive() { return collect(self::getInformazioni()['risorse-api']); } /** * Controlla se il gestionale ha accesso a una specifica risorsa di Services. * * @return bool */ public static function verificaRisorsaAttiva($servizio) { return self::isEnabled() && self::getRisorseAttive()->search(function ($item) use ($servizio) { return $item['name'] == $servizio; }) !== false; } /** * Restituisce le risorse in scadenza per assenza di crediti oppure per data di fine prossima. * * @param Carbon $limite_scadenze * * @return \Illuminate\Support\Collection */ public static function getRisorseInScadenza($limite_scadenze) { return self::getRisorseAttive() ->filter(function ($item) use ($limite_scadenze) { return (isset($item['expiration_at']) && Carbon::parse($item['expiration_at'])->lessThan($limite_scadenze)) || (isset($item['credits']) && $item['credits'] < 100); }); } /** * Effettua una richiesta a Services. * * @param $type * @param $resource * @param array $data * @param array $options * * @throws \GuzzleHttp\Exception\GuzzleException * * @return \Psr\Http\Message\ResponseInterface */ public static function request($type, $resource, $data = [], $options = []) { $client = static::getClient(); $json = array_merge($data, [ 'token' => setting('OSMCloud Services API Token'), 'version' => setting('OSMCloud Services API Version'), 'resource' => $resource, ]); $options = array_merge($options, [ 'json' => $json, 'http_errors' => false, ]); return $client->request($type, '', $options); } /** * Restituisce il corpo JSON della risposta in array. * * @param $response * * @return array */ public static function responseBody($response) { $body = $response->getBody(); return json_decode($body, true) ?: []; } /** * Restituisce l'oggetto per la connessione all'API del progetto. * * @return Client */ protected static function getClient() { if (!isset(self::$client)) { $url = setting('OSMCloud Services API URL'); self::$client = new Client([ 'base_uri' => $url, 'verify' => false, ]); } return self::$client; } }