Oltre alla funzionalità di screenshot standard API Ruby di GrabzIt consente agli sviluppatori di integrate a stretto contatto con GrabzIt consentendo all'applicazione di agganciarsi into il funzionamento interno del servizio GrabzIt, ad esempio controllando lo stato degli screenshot esistenti e impostando i cookie che GrabzIt utilizzerà durante l'acquisizione di contenuti Web.
Potrebbe essere necessario che un'applicazione controlli lo stato di un'acquisizione e questo è il caso get_status è utile, restituisce un oggetto che indica se un'acquisizione è ancora in elaborazione, memorizzata nella cache o scaduta insieme alla restituzione di eventuali messaggi di errore associati all'acquisizione.
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret") status = grabzItClient.get_status(screenShotId) if status.processing #screenshot has not yet been processed end if status.cached #screenshot is still cached by GrabzIt end if status.expired #screenshot is no longer on GrabzIt #Perhaps output status message? raise status.message end
Quasi tutti i siti Web controllano la funzionalità con i cookie. Per consentire all'utente di modificare le funzioni del sito Web di destinazione GrabzIt espone i seguenti metodi di cookie, per ulteriori informazioni sui parametri disponibili per questi metodi si prega di leggere il documentazione del cliente.
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret") #gets an array of cookies for google.com cookies = grabzItClient.get_cookies("google.com") #sets a cookie for the google.com domain grabzItClient.set_cookie("MyCookie", "google.com", "Any Value You Like") #deletes the previously set cookie grabzItClient.delete_cookie("MyCookie", "google.com")
Si consiglia di scaricare un'acquisizione su un server Web prima di utilizzarla. Tuttavia, è possibile visualizzare qualsiasi tipo di acquisizione nel browser di un utente senza scaricarlo prima sul server Web.
Per fare ciò, una volta terminata l'acquisizione è possibile inviare i byte dell'acquisizione restituiti da save_to metodo alla risposta insieme a tipo di mime corretto.
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret") grabzItClient.url_to_image("https://www.tesla.com") capture = grabzItClient.save_to();
Nell'esempio precedente otteniamo i byte dell'acquisizione, ma il modo in cui viene restituito alla risposta dipenderà dal framework in uso.