Dokumentacja klasy ElibriWatermarkingClient

ElibriAPI abstrahuje wykorzystanie API udostępniane przez eLibri. Więcej...

Metody publiczne

 __construct ($token, $secret, $host="https://www.elibri.com.pl")
 Kontruktor obiektu API. Więcej...
 
 watermark ($ident, $formats, $visible_watermark, $client_symbol=NULL)
 Zlecaj watermarkowanie. Żeby skrócić maksymalnie oczekiwanie klienta na plik, podzieliliśmy cały proces watermarkingu na dwa etapy. Proponujemy, żeby zlecać watermarking tak wcześnie, jak to tylko możliwe (na przykład wtedy, gdy klient opuści koszyk, i poda swoje dane) elibri rozpoczyna wtedy watermarkowanie książki, ale nie udostępnia jeszcze pliku sklepowi, ani nie rejestruje transakcji. Dopiero po dokonaniu płatności przez klienta należy wywołać metodę deliver, która to asynchronicznie dostarczy linki do plik do sklepu. Więcej...
 
 deliver ($trans_id)
 Dostarcz plik oraz zajestruj transakcję Ta metoda powinna zostać wywołana po watermark. Sklep powinien ją wywołać po zarejestrowaniu płatności przez klienta. Zwatermarkowany plik (pliki) zostaną przekopiowane do bucketu na amazon S3, który jest przypisany do sklepu. Sklep jest zobowiązany do wykasowania pliku po jego ściągnięciu. Więcej...
 
 available_files ()
 Pobierz listę dostępnych plików Za pomocą tej metody możesz pobrać listę książek, które są lub będą w najbliższym czasie dostępne w systemie eLibri.
 
 soon_available_files ()
 Ponierz listę plików, których premiera się zbliża Za pomocą tej metody możesz pobrać listę ksiażek, które nie są w tej chwili dostępne, ale ich premiera jest wkrótce.
 
 soon_unavailable_files ()
 Ponierz listę plików, które wkrótce przestaną być dostępne Za pomocą tej metody możesz pobrać listę ksiażek, które wkrótce przestaną być dostępne.
 

Opis szczegółowy

ElibriAPI abstrahuje wykorzystanie API udostępniane przez eLibri.

Dokumentacja konstruktora i destruktora

◆ __construct()

ElibriWatermarkingClient::__construct (   $token,
  $secret,
  $host = "https://www.elibri.com.pl" 
)

Kontruktor obiektu API.

Parametry
String$token- publiczny token eLibri Watermarking API
String$secret- prywatny token eLibri Watermarking API
Array$subdomains- lista subdomen, opcjonalnie. Przydatne, gdy używana wersja PHP nie zawiera metody dns_get_record

Dokumentacja funkcji składowych

◆ deliver()

ElibriWatermarkingClient::deliver (   $trans_id)

Dostarcz plik oraz zajestruj transakcję Ta metoda powinna zostać wywołana po watermark. Sklep powinien ją wywołać po zarejestrowaniu płatności przez klienta. Zwatermarkowany plik (pliki) zostaną przekopiowane do bucketu na amazon S3, który jest przypisany do sklepu. Sklep jest zobowiązany do wykasowania pliku po jego ściągnięciu.

Parametry
String$trans_id- alfanumeryczny identyfikator transakcji zwrócony przez metodę watermark

◆ watermark()

ElibriWatermarkingClient::watermark (   $ident,
  $formats,
  $visible_watermark,
  $client_symbol = NULL 
)

Zlecaj watermarkowanie. Żeby skrócić maksymalnie oczekiwanie klienta na plik, podzieliliśmy cały proces watermarkingu na dwa etapy. Proponujemy, żeby zlecać watermarking tak wcześnie, jak to tylko możliwe (na przykład wtedy, gdy klient opuści koszyk, i poda swoje dane) elibri rozpoczyna wtedy watermarkowanie książki, ale nie udostępnia jeszcze pliku sklepowi, ani nie rejestruje transakcji. Dopiero po dokonaniu płatności przez klienta należy wywołać metodę deliver, która to asynchronicznie dostarczy linki do plik do sklepu.

Parametry
String$ident- ISBN13 (bez myślików), lub record_reference
String$formats- 'mobi', 'epub', lub 'mobi,epub'
String$visible_watermark- stopka doklejana na końcu każdego rozdziału
String$client_symbol- opcjonalny identyfikator promocji
Zwraca
$transid - alfanumeryczny identyfikator transakcji