API PHP do GrabzIt é altamente personalizável e é capaz de integrate firmemente into seu aplicativo. Ele expõe muitos trabalhos internos do GrabzIt, para que você possa personalizar o máximo possível o uso do GrabzIt. Dois exemplos disso são verificar o status das capturas de tela existentes e configurar os cookies que o GrabzIt usará ao capturar capturas de tela ou capturar conteúdo.
Use o método GetStatus para permitir que seu aplicativo verifique o status de uma captura de tela, talvez para ver se ainda está em processamento ou se está em cache e pronto para ser usado.
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret"); $status = $grabzIt.GetStatus(screenShotId); if ($status->Processing) { // screenshot has not yet been processed } if ($status->Cached) { // screenshot is still cached by GrabzIt } if ($status->Expired) { // screenshot is no longer on GrabzIt // Perhaps output status message? die $status->Message; }
A maioria dos sites usa cookies para controlar a funcionalidade. Para permitir que você controle esse aspecto da funcionalidade do site, o GrabzIt permite que você defina seus próprios cookies personalizados com os seguintes métodos de cookie.
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret"); // gets an array of cookies for google.com $cookies = $grabzIt->GetCookies("google.com"); // sets a cookie for the google.com domain $grabzIt->SetCookie("MyCookie", "google.com", "Any Value You Like"); // deletes the previously set cookie $grabzIt->DeleteCookie("MyCookie", "google.com");
Embora seja recomendável baixar uma captura para um servidor Web antes de exibi-la. Você também pode exibir qualquer tipo de captura no navegador de um usuário sem fazer o download no servidor da web. No entanto, para que essa técnica funcione, o usuário precisará aguardar a conclusão da captura.
Depois de concluído, você pode enviar os bytes da captura retornados pelo SaveTo método para a resposta junto com o tipo mime correto.
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret"); $grabzIt->URLToImage("https://www.tesla.com"); header("Content-Type: image/jpeg"); echo $grabzIt->SaveTo();
Como você pode ver no exemplo acima, nenhum nome de arquivo está sendo passado para o diretório SaveTo método que faz com que o método retorne o conteúdo da captura.