E-booki | Dokumentacja API

<EpubTechnicalProtection> Określa typ zabezpieczenia stosowanego przy publikacji e-booka.

<ProductFormDetail> zawiera format w jakim rozprowadzany jest e-book. Aktualnie może przyjąć wartości takie jak: EPUB, PDF lub Mobipocket

Przykład

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage release="3.0" xmlns="http://ns.editeur.org/onix/3.0/reference" xmlns:elibri="http://elibri.com.pl/ns/extensions">
  <elibri:Dialect>3.0.1</elibri:Dialect>
  <Header>
    <Sender>
      <SenderName>Elibri.com.pl</SenderName>
      <ContactName>Tomasz Meka</ContactName>
      <EmailAddress>kontakt@elibri.com.pl</EmailAddress>
    </Sender>
    <SentDateTime>20181211</SentDateTime>
  </Header>
  <Product>
    <!-- $onix_record_identifiers$ Unikalne ID rekordu produktu -->
    <RecordReference>fdb8fa072be774d97a97</RecordReference>
    <!-- $onix_publishing_status$ Typ powiadomienia
    01 - wczesne powiadomienie
    02 - późne powiadomienie
    03 - powiadomienie o publikacji
    05 - usunięcie rekordu
    12 - uaktualnienie tylko informacji o dostępności -->
    <NotificationType>03</NotificationType>
    <!-- $onix_record_identifiers$ ISBN -->
    <ProductIdentifier>
      <ProductIDType>15</ProductIDType>
      <IDValue>9788324799992</IDValue>
    </ProductIdentifier>
    <DescriptiveDetail>
      <!-- $onix_product_form$ W tej chwili tylko 00 - pojedynczy element -->
      <ProductComposition>00</ProductComposition>
      <!-- $onix_product_form$ Format produktu
          BA - książka
          EA - e-book
          AJ - audiobook w formie pliku
          AC - audiobook na płycie CD
          AI - audiobook na płycie DVD
          CA - mapa
          CB - mapa składana
          CC - mapa płaska
          CD - mapa w rolce
          CZ - inny format kartograficzny
          PC - kalendarz
          ZE - gra planszowa / puzzle -->
      <ProductForm>EA</ProductForm>
      <!-- $onix_epub_details$ Dostępne formaty produktu
          E101 - EPUB
          E107 - PDF
          E127 - Mobipocket -->
      <ProductFormDetail>E101</ProductFormDetail>
      <ProductFormDetail>E127</ProductFormDetail>
      <!-- $onix_epub_details$ Zabezpieczenie
          00 - brak
          01 - DRM
          02 - watermark -->
      <EpubTechnicalProtection>01</EpubTechnicalProtection>
      <TitleDetail>
        <!-- $onix_titles$ Pełen tytuł produktu - 01 -->
        <TitleType>01</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>Nielegalni</TitleText>
        </TitleElement>
      </TitleDetail>
    </DescriptiveDetail>
    <PublishingDetail>
      <Publisher>
        <!-- $onix_publisher_info$ Wydawca - używamy tylko kodu 01 (główny wydawca) -->
        <PublishingRole>01</PublishingRole>
        <PublisherIdentifier>
          <PublisherIDType>01</PublisherIDType>
          <IDTypeName>ElibriPublisherCode</IDTypeName>
          <IDValue>11</IDValue>
        </PublisherIdentifier>
        <PublisherName>GREG</PublisherName>
      </Publisher>
      <CityOfPublication>Warszawa</CityOfPublication>
      <!-- $onix_publishing_status$ Status publikacji
          00 - nieokreślony
          01 - anulowany
          02 - nadchodzący
          04 - w sprzedaży
          07 - nakład wyczerpany
          08 - niedostępny -->
      <PublishingStatus>04</PublishingStatus>
      <SalesRights>
        <!-- $onix_territorial_rights$ Typ restrykcji - sprzedaż tylko w wymienionym kraju, regionie, zawsze '01' -->
        <SalesRightsType>01</SalesRightsType>
        <Territory>
          <RegionsIncluded>WORLD</RegionsIncluded>
        </Territory>
      </SalesRights>
    </PublishingDetail>
    <!-- Cena na okładce -->
    <!-- Vat w procentach -->
    <elibri:preview_exists>false</elibri:preview_exists>
    <elibri:SaleRestrictedTo>20140307</elibri:SaleRestrictedTo>
  </Product>
</ONIXMessage>

Wydawca może również umieścić informacje o tym, czy pozwala na publikację fragmentu książki, a jeśli tak, to czy narzuca ograniczenie co do wielkości fragmentu (w ilości znaków albo procentowo). Ta informacja ma tylko wtedy znaczenie, gdy dystrybutor samodzielnie dokonuje konwersji, a tym samym tworzy ebooka z fragmentem publikacji. Wydawnictwa, które samodzielnie konwertują książki nie będą publikować tej informacji.

E-book, brak limitu co do wielkości bezpłatnego fragmentu

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage release="3.0" xmlns="http://ns.editeur.org/onix/3.0/reference" xmlns:elibri="http://elibri.com.pl/ns/extensions">
  <elibri:Dialect>3.0.1</elibri:Dialect>
  <Header>
    <Sender>
      <SenderName>Elibri.com.pl</SenderName>
      <ContactName>Tomasz Meka</ContactName>
      <EmailAddress>kontakt@elibri.com.pl</EmailAddress>
    </Sender>
    <SentDateTime>20181211</SentDateTime>
  </Header>
  <Product>
    <!-- $onix_record_identifiers$ Unikalne ID rekordu produktu -->
    <RecordReference>fdb8fa072be774d97a97</RecordReference>
    <!-- $onix_publishing_status$ Typ powiadomienia
    01 - wczesne powiadomienie
    02 - późne powiadomienie
    03 - powiadomienie o publikacji
    05 - usunięcie rekordu
    12 - uaktualnienie tylko informacji o dostępności -->
    <NotificationType>03</NotificationType>
    <!-- $onix_record_identifiers$ ISBN -->
    <ProductIdentifier>
      <ProductIDType>15</ProductIDType>
      <IDValue>9788324799992</IDValue>
    </ProductIdentifier>
    <DescriptiveDetail>
      <!-- $onix_product_form$ W tej chwili tylko 00 - pojedynczy element -->
      <ProductComposition>00</ProductComposition>
      <!-- $onix_product_form$ Format produktu
          BA - książka
          EA - e-book
          AJ - audiobook w formie pliku
          AC - audiobook na płycie CD
          AI - audiobook na płycie DVD
          CA - mapa
          CB - mapa składana
          CC - mapa płaska
          CD - mapa w rolce
          CZ - inny format kartograficzny
          PC - kalendarz
          ZE - gra planszowa / puzzle -->
      <ProductForm>EA</ProductForm>
      <EpubUsageConstraint>
        <!-- $onix_epub_details$ Rodzaj ograniczenia - w tym przypadku zawsze dotyczy dostępności fragmentu książki -->
        <EpubUsageType>01</EpubUsageType>
        <!-- $onix_epub_details$ Jaka jest decyzja wydawcy?
            01 - bez ograniczeń
            02 - obowiązuje ograniczenie
            03 - zabronione -->
        <EpubUsageStatus>01</EpubUsageStatus>
      </EpubUsageConstraint>
      <TitleDetail>
        <!-- $onix_titles$ Pełen tytuł produktu - 01 -->
        <TitleType>01</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>Nielegalni</TitleText>
        </TitleElement>
      </TitleDetail>
    </DescriptiveDetail>
    <PublishingDetail>
      <Publisher>
        <!-- $onix_publisher_info$ Wydawca - używamy tylko kodu 01 (główny wydawca) -->
        <PublishingRole>01</PublishingRole>
        <PublisherIdentifier>
          <PublisherIDType>01</PublisherIDType>
          <IDTypeName>ElibriPublisherCode</IDTypeName>
          <IDValue>11</IDValue>
        </PublisherIdentifier>
        <PublisherName>GREG</PublisherName>
      </Publisher>
      <CityOfPublication>Warszawa</CityOfPublication>
      <!-- $onix_publishing_status$ Status publikacji
          00 - nieokreślony
          01 - anulowany
          02 - nadchodzący
          04 - w sprzedaży
          07 - nakład wyczerpany
          08 - niedostępny -->
      <PublishingStatus>04</PublishingStatus>
      <SalesRights>
        <!-- $onix_territorial_rights$ Typ restrykcji - sprzedaż tylko w wymienionym kraju, regionie, zawsze '01' -->
        <SalesRightsType>01</SalesRightsType>
        <Territory>
          <RegionsIncluded>WORLD</RegionsIncluded>
        </Territory>
      </SalesRights>
    </PublishingDetail>
    <!-- Cena na okładce -->
    <!-- Vat w procentach -->
    <elibri:preview_exists>false</elibri:preview_exists>
    <elibri:SaleNotRestricted/>
  </Product>
</ONIXMessage>

Publikowanie fragmentu zabronione

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage release="3.0" xmlns="http://ns.editeur.org/onix/3.0/reference" xmlns:elibri="http://elibri.com.pl/ns/extensions">
  <elibri:Dialect>3.0.1</elibri:Dialect>
  <Header>
    <Sender>
      <SenderName>Elibri.com.pl</SenderName>
      <ContactName>Tomasz Meka</ContactName>
      <EmailAddress>kontakt@elibri.com.pl</EmailAddress>
    </Sender>
    <SentDateTime>20181211</SentDateTime>
  </Header>
  <Product>
    <!-- $onix_record_identifiers$ Unikalne ID rekordu produktu -->
    <RecordReference>fdb8fa072be774d97a97</RecordReference>
    <!-- $onix_publishing_status$ Typ powiadomienia
    01 - wczesne powiadomienie
    02 - późne powiadomienie
    03 - powiadomienie o publikacji
    05 - usunięcie rekordu
    12 - uaktualnienie tylko informacji o dostępności -->
    <NotificationType>03</NotificationType>
    <!-- $onix_record_identifiers$ ISBN -->
    <ProductIdentifier>
      <ProductIDType>15</ProductIDType>
      <IDValue>9788324799992</IDValue>
    </ProductIdentifier>
    <DescriptiveDetail>
      <!-- $onix_product_form$ W tej chwili tylko 00 - pojedynczy element -->
      <ProductComposition>00</ProductComposition>
      <!-- $onix_product_form$ Format produktu
          BA - książka
          EA - e-book
          AJ - audiobook w formie pliku
          AC - audiobook na płycie CD
          AI - audiobook na płycie DVD
          CA - mapa
          CB - mapa składana
          CC - mapa płaska
          CD - mapa w rolce
          CZ - inny format kartograficzny
          PC - kalendarz
          ZE - gra planszowa / puzzle -->
      <ProductForm>EA</ProductForm>
      <EpubUsageConstraint>
        <!-- $onix_epub_details$ Rodzaj ograniczenia - w tym przypadku zawsze dotyczy dostępności fragmentu książki -->
        <EpubUsageType>01</EpubUsageType>
        <!-- $onix_epub_details$ Jaka jest decyzja wydawcy?
            01 - bez ograniczeń
            02 - obowiązuje ograniczenie
            03 - zabronione -->
        <EpubUsageStatus>03</EpubUsageStatus>
      </EpubUsageConstraint>
      <TitleDetail>
        <!-- $onix_titles$ Pełen tytuł produktu - 01 -->
        <TitleType>01</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>Nielegalni</TitleText>
        </TitleElement>
      </TitleDetail>
    </DescriptiveDetail>
    <PublishingDetail>
      <Publisher>
        <!-- $onix_publisher_info$ Wydawca - używamy tylko kodu 01 (główny wydawca) -->
        <PublishingRole>01</PublishingRole>
        <PublisherIdentifier>
          <PublisherIDType>01</PublisherIDType>
          <IDTypeName>ElibriPublisherCode</IDTypeName>
          <IDValue>11</IDValue>
        </PublisherIdentifier>
        <PublisherName>GREG</PublisherName>
      </Publisher>
      <CityOfPublication>Warszawa</CityOfPublication>
      <!-- $onix_publishing_status$ Status publikacji
          00 - nieokreślony
          01 - anulowany
          02 - nadchodzący
          04 - w sprzedaży
          07 - nakład wyczerpany
          08 - niedostępny -->
      <PublishingStatus>04</PublishingStatus>
      <SalesRights>
        <!-- $onix_territorial_rights$ Typ restrykcji - sprzedaż tylko w wymienionym kraju, regionie, zawsze '01' -->
        <SalesRightsType>01</SalesRightsType>
        <Territory>
          <RegionsIncluded>WORLD</RegionsIncluded>
        </Territory>
      </SalesRights>
    </PublishingDetail>
    <!-- Cena na okładce -->
    <!-- Vat w procentach -->
    <elibri:preview_exists>false</elibri:preview_exists>
    <elibri:SaleNotRestricted/>
  </Product>
</ONIXMessage>

Podany limit wielkości fragmentu

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage release="3.0" xmlns="http://ns.editeur.org/onix/3.0/reference" xmlns:elibri="http://elibri.com.pl/ns/extensions">
  <elibri:Dialect>3.0.1</elibri:Dialect>
  <Header>
    <Sender>
      <SenderName>Elibri.com.pl</SenderName>
      <ContactName>Tomasz Meka</ContactName>
      <EmailAddress>kontakt@elibri.com.pl</EmailAddress>
    </Sender>
    <SentDateTime>20181211</SentDateTime>
  </Header>
  <Product>
    <!-- $onix_record_identifiers$ Unikalne ID rekordu produktu -->
    <RecordReference>fdb8fa072be774d97a97</RecordReference>
    <!-- $onix_publishing_status$ Typ powiadomienia
    01 - wczesne powiadomienie
    02 - późne powiadomienie
    03 - powiadomienie o publikacji
    05 - usunięcie rekordu
    12 - uaktualnienie tylko informacji o dostępności -->
    <NotificationType>03</NotificationType>
    <!-- $onix_record_identifiers$ ISBN -->
    <ProductIdentifier>
      <ProductIDType>15</ProductIDType>
      <IDValue>9788324799992</IDValue>
    </ProductIdentifier>
    <DescriptiveDetail>
      <!-- $onix_product_form$ W tej chwili tylko 00 - pojedynczy element -->
      <ProductComposition>00</ProductComposition>
      <!-- $onix_product_form$ Format produktu
          BA - książka
          EA - e-book
          AJ - audiobook w formie pliku
          AC - audiobook na płycie CD
          AI - audiobook na płycie DVD
          CA - mapa
          CB - mapa składana
          CC - mapa płaska
          CD - mapa w rolce
          CZ - inny format kartograficzny
          PC - kalendarz
          ZE - gra planszowa / puzzle -->
      <ProductForm>EA</ProductForm>
      <EpubUsageConstraint>
        <!-- $onix_epub_details$ Rodzaj ograniczenia - w tym przypadku zawsze dotyczy dostępności fragmentu książki -->
        <EpubUsageType>01</EpubUsageType>
        <!-- $onix_epub_details$ Jaka jest decyzja wydawcy?
            01 - bez ograniczeń
            02 - obowiązuje ograniczenie
            03 - zabronione -->
        <EpubUsageStatus>02</EpubUsageStatus>
        <EpubUsageLimit>
          <Quantity>10</Quantity>
          <!-- $onix_epub_details$ Jednostka limitu
            02 - znaków
            05 - procent -->
          <EpubUsageUnit>05</EpubUsageUnit>
        </EpubUsageLimit>
      </EpubUsageConstraint>
      <TitleDetail>
        <!-- $onix_titles$ Pełen tytuł produktu - 01 -->
        <TitleType>01</TitleType>
        <TitleElement>
          <!-- $onix_titles$ Tytuł na poziomie produktu - 01 -->
          <TitleElementLevel>01</TitleElementLevel>
          <TitleText>Nielegalni</TitleText>
        </TitleElement>
      </TitleDetail>
    </DescriptiveDetail>
    <PublishingDetail>
      <Publisher>
        <!-- $onix_publisher_info$ Wydawca - używamy tylko kodu 01 (główny wydawca) -->
        <PublishingRole>01</PublishingRole>
        <PublisherIdentifier>
          <PublisherIDType>01</PublisherIDType>
          <IDTypeName>ElibriPublisherCode</IDTypeName>
          <IDValue>11</IDValue>
        </PublisherIdentifier>
        <PublisherName>GREG</PublisherName>
      </Publisher>
      <CityOfPublication>Warszawa</CityOfPublication>
      <!-- $onix_publishing_status$ Status publikacji
          00 - nieokreślony
          01 - anulowany
          02 - nadchodzący
          04 - w sprzedaży
          07 - nakład wyczerpany
          08 - niedostępny -->
      <PublishingStatus>04</PublishingStatus>
      <SalesRights>
        <!-- $onix_territorial_rights$ Typ restrykcji - sprzedaż tylko w wymienionym kraju, regionie, zawsze '01' -->
        <SalesRightsType>01</SalesRightsType>
        <Territory>
          <RegionsIncluded>WORLD</RegionsIncluded>
        </Territory>
      </SalesRights>
    </PublishingDetail>
    <!-- Cena na okładce -->
    <!-- Vat w procentach -->
    <elibri:preview_exists>false</elibri:preview_exists>
    <elibri:SaleNotRestricted/>
  </Product>
</ONIXMessage>

Wydawnictwa podają też w systemie eLibri informację, czy prawo do sprzedaży ebook-a jest bezterminowe. W takim przypadku w opisie produktu wystąpi pusty tag <elibri:SaleNotRestricted> (ostatnie trzy przykłady).

Jeśli wydawca posiada licencję na określony czas, to w opisie produktu wystąpi tag <elibri:SaleRestrictedTo>, w którym będzie podana data wygaśnięcia licencji (w formacie YYYYMMDD). Przykład użycia w pierwszym przykładzie.

Elibri

Dystrybucja informacji o książkach

API systemu Elibri

ONIX

Podglądy

Wydrukuj dokumentację

kontakt