Obálkyknih.cz - Jihočeská vědecká knihovna v Českých Budějovicích

Novinky

2020-08-18	Přidán nový výstup obálek titulů služby DNNT dostupných v Národní digitální knihovně NK ČR.
2019-01-31	Do výstupu obálek, ... přidáno hodnocení titulů - parametry cached_rating_sum a cached_rating_count. (cached_rating_sum/cached_rating_count = procentní hodnocení titulu).
2018-12-18	Možnost stažení nového výstupu - PHP pole s identifikátory dokumentů a ID obálky. Výrazně urychlí zjištění ID cover pro hromadné dotazy pomocí skriptů (např. generování seznamů novinek).

Popis

Exporty z databáze projektu obálkyknih.cz pro hromadné importy dat do knihovních systémů či generování seznamů novinek, přehledů apod.

Výstupy jsou generovány 1x denně v noci a poskytovány ve formátu XML (UTF-8 kódování).

Jako volitelný parametr při volání skriptu lze použít parametr last_change.

Příklad: https://servis.obalkyknih.cz/export/okcz_annotation.php?last_change=2021-01-01

Výstup vrací poté pouze záznamy změněné či vytvořené po tomto datu (včetně uvedeného data). Formát datumu je dle vzoru YYYY-MM-DD. Výstupy jsou generovány online a tudíž trvají delší dobu (10-30s). Z důvodu zabránění zahlcení serveru jsou vypisovány záznamy změněné maximálně za poslední rok. Doporučujeme nastavit pravidelné stahováni - např. po týdnu - a raději v nočních hodinách.

Z výstupu pomocí hodnot cover_id, toc_id a bib_id lze vygenerovat URL k příslušným souborům dle vzoru:

https://server <cache1|cache2>.obalkyknih.cz/file/typ objektu <cover|toc|bib>/id <cover_id |toc_id|bib_id>/velikost náhledu či typ souboru <pdf|thumbnail|icon|medium|preview510>

Hodnoty cover_id, toc_id a bib_id se při aktualizacích záznamů mění. !!! XML exporty neslouží pro trvalé propojení knihovních záznamů se záznamy projektu obalkyknih.cz !!! Pro běžný provoz použijte funkce popsané v API projektu.

Příklady:

https://cache1.obalkyknih.cz/file/cover/755239/thumbnail - náhled obálky velikosti thumbnail (27x36px) záznamu s cover_id 755239 (server cache1.obalkyknih.cz)
https://cache2.obalkyknih.cz/file/cover/755239/icon - náhled obálky velikosti icon (54x68px) záznamu s cover_id 755239 (server cache2.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/cover/755239/medium - náhled obálky velikosti medium (170x240px) záznamu s cover_id 755239 (server cache1.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/cover/755239/preview510 - náhled obálky velikosti preview510 (510x720px, pokud je dostupná tato velikost) záznamu s cover_id 755239 (server cache2.obalkyknih.cz)
https://cache2.obalkyknih.cz/file/toc/472/thumbnail - náhled první stránky obsahu (170x240px) záznamu s toc_id 472 (server cache2.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/toc/472/pdf - PDF soubor s obsahem záznamu s toc_id 472 (server cache1.obalkyknih.cz)
https://cache2.obalkyknih.cz/file/bib/2/thumbnail - náhled první stránky seznamu literatury (170x240px) záznamu s bib_id 193472 (server cache2.obalkyknih.cz)
https://cache1.obalkyknih.cz/file/bib/2/pdf - PDF soubor se seznamem literatury záznamu s bib_id 2 (server cache1.obalkyknih.cz)

Ukázkové náhledy jsou dostupné jen v případě platné registrace URL nebo IP adresy pro konkrétní knihovnu. Více informací v API projektu.

Přístup

Stahovat XML soubory je umožněno pouze registracím s právem k stahování příslušných dat (běžné registrace tuto možnost nemají).

Zájemci o stahování prosím kontaktujte správce projektu admin@obalkyknih.cz. Na stejný email posílejte i připomínky, návrhy na změny či zjištěné chyby.

Příklad stažení XML souboru:

wget -O okcz-annotation.xml --http-user=xxx@xxx.cz --http-passwd=xxx https://servis.obalkyknih.cz/export/okcz_annotation.php

Seznam výstupů

obálky, obsahy, seznam literatury, hodnocení
anotace
OCR obsahy
obálky - PHP array

OBÁLKA, OBSAH, SEZNAM LITERATURY, HODNOCENÍ

link: https://servis.obalkyknih.cz/export/okcz_ident.php
velikost soubor (plný export): 276.72 MB
datum posledního exportu: 2021-01-24 05:41:03
struktura XML - obálky,obsahy,seznam literatury,hodnocení:
- obalkyknih .. parametr date obsahuje datum exportu XML souboru, parametr last_change obsahuje info o rozsahu hledáni (all ... všechny záznamy, YYYY-MM-DD ... záznamy změněné od data ... )
  - book ... sekce konkrétního titulu
  - - bibinfo ... sekce s identifikátory titulu
      
      ean13 ... ISBN, ISSN nebo EAN standardizované v 13-ti místném formátu
      
      oclc ... OCoLC
      
      cnb ... číslo ČNB (popříp. vlastní dentifikátor konkrétní knihovny - pokud titul nemá č. ČNB)
    - book_id ... ID záznamu na serveru obalkyknih.cz
    - book_metadata_change ... datum poslední změny záznamu
    - cover_id ... id obálky
    - toc_id ... id obsahu
    - bib_id ... id seznamu literatury
    - cached_rating_sum ... suma hodnocení titulu
    - cached_rating_count ... počet hodnocení titulu

ukázka XML - obálky,obsahy,seznam literatury:

            <?xml version="1.0" encoding="UTF-8"?>
            <obalkyknih date="2021-01-28 00:01:01" last_change="all">
              <book>
                <bibinfo>
                  <ean13>9788090333383</ean13>
                  <cnb>cnb001581391</cnb>
                  <oclc>(OCoLC)63296281</oclc>
                </bibinfo>
                <book_id>110000002</book_id>
                <book_metadata_change>2018-04-18 16:10:17</book_metadata_change>
                <cover_id>2</cover_id>
                <toc_id>120596</toc_id>
                <bib_id>23456</bib_id>
                <cached_rating_sum>120</cached_rating_sum>
                <cached_rating_count>2</cached_rating_count>
              </book>
              <book>
                  ...
              </book>      
            </obalkyknih>

ANOTACE

link: https://servis.obalkyknih.cz/export/okcz_annotation.php
velikost soubor (plný export): 437.87 MB
datum posledního exportu: 2021-01-24 05:40:42
struktura XML - anotace:
- obalkyknih .. parametr date obsahuje datum exportu XML souboru, parametr last_change obsahuje info o rozsahu hledáni (all ... všechny záznamy, YYYY-MM-DD ... záznamy změněné od data ... )
  - book ... sekce konkrétního titulu
  - - bibinfo ... sekce s identifikátory titulu
      
      ean13 ... ISBN, ISSN nebo EAN standardizované v 13-ti místném formátu
      
      oclc ... OCoLC
      
      cnb ... číslo ČNB (popříp. vlastní dentifikátor konkrétní knihovny - pokud titul nemá č. ČNB)
    - book_id ... ID záznamu na serveru obalkyknih.cz
    - book_metadata_change ... datum poslední změny anotace
    - annotation ... vlastní anotace

ukázka XML - anotace:

            <?xml version="1.0" encoding="UTF-8"?>
            <obalkyknih date="2021-01-28 00:01:01" last_change="all">
              <book>
                <bibinfo>
                  <ean13>9788024730479</ean13>
                  <oclc>(OCoLC)428366326</oclc>
                </bibinfo>
                <book_id>110270750</book_id>
                <book_metadata_change>2018-02-12 07:08:25</book_metadata_change>
                <annotation>Cílem publikace je představit čtenářům charakteristiku open-source software a otevřených formátů. ...</annotation>
              </book>
              <book>
                  ...
              </book>      
            </obalkyknih>

OCR OBSAHY

link: https://servis.obalkyknih.cz/export/okcz_toc.php
velikost soubor (plný export): 0 bytes
datum posledního exportu: 2021-01-24 05:47:15
struktura XML - OCR obsahy::
- obalkyknih .. parametr date obsahuje datum exportu XML souboru, parametr last_change obsahuje info o rozsahu hledáni (all ... všechny záznamy, YYYY-MM-DD ... záznamy změněné od data ... )
  - book ... sekce konkrétního titulu
  - - bibinfo ... sekce s identifikátory titulu
      
      ean13 ... ISBN, ISSN nebo EAN standardizované v 13-ti místném formátu
      
      oclc ... OCoLC
      
      cnb ... číslo ČNB (popříp. vlastní dentifikátor konkrétní knihovny - pokud titul nemá č. ČNB)
    - book_id ... ID záznamu na serveru obalkyknih.cz
    - book_metadata_change ... datum poslední změny anotace
    - toc ... vlastní text obsahu zpracovaný OCR

ukázka XML - OCR obsahy:

            <?xml version="1.0" encoding="UTF-8"?>
            <obalkyknih date="2021-01-28 00:01:01" last_change="all">
              <book>
                <bibinfo>
                  <ean13>9788023946604</ean13>
                  <oclc>(OCoLC)85543420</oclc>
                  <cnb>cnb001527995</cnb>
                </bibinfo>
                <book_id>110256461</book_id>
                <book_metadata_change>2009-10-17 17:48:40</book_metadata_change>
                <toc>Ždánický les a Povltaví\r\nObsah\r\nÚvodní slovo (Ing. Jiří Slabotinský, CSc.) ...</toc>
              </book>
              <book>
                  ...
              </book>      
            </obalkyknih>

OBÁLKY - PHP ARRAY

Export identifikátorů (ISBN, ISSN, ISMN, EAN, OCLC, č. ČNB, vlastní identifikátor) s parametrem cover_id (ID obálky titulu v projektu obalkyknih.cz). Export je ve formátu asociativního pole pro zpracování pomocí PHP. ISBN, ISSN a EAN je uvedeno v 13-ti místném tvaru.

Ukázku PHP funkce pro převod do tohoto formátu naleznete zde.

Výstup vznikl pro potřeby naší knihovny pravidelně generovat seznamy náhledů obálek jednotlivých druhů dokumentů (knihy, DVD, CD, e-knihy, periodika, hry, ...). Ukázka "reklamního systému" v našem katalogu. Dotazy přes klasické API projektu obalkyknih.cz trvalo u cca. 500 tisíc dokumentů 2-3 hodiny. Dotaz na stejný počet dokumentů pomocí asociativního pole trvá pouhých 20-30 vteřin.

link: https://servis.obalkyknih.cz/export/dump/ident-okcz.cz.php.tgz
velikost soubor (plný export): 16.68 MB
datum posledního exportu: 2021-01-24 05:40:05
struktura pole - obálky PHP array:

"KLÍČ:identifikátor" => "HODNOTA:cover_id",

ukázka PHP pole - obálky:

            
      $identokcz=array(
              "9788090333383" => "2",
              "9788071785453" => "13",
              "9788024407210" => "18",
              "9788071785132" => "21",
              "(OCoLC)977969365" => "1912265",
              "(OCoLC)978015693" => "1667917",
              "(OCoLC)978253247" => "1675105",
              "(OCoLC)978261032" => "1685055",
              "cnb001801833" => "652552",
              "cnb001802620" => "652559",
              "cnb001801228" => "652563",
              "cnb001807474" => "652565",
              "cba001-0075434" => "653231",
    );

OBÁLKY DNNT - PHP ARRAY

Export ID obálky titulu v projektu obalkyknih.cz obálky v systému OKCZ a uuid titulu v systému DNNT Národní digitální knihovny NK ČR. Export je ve formátu asociativního pole pro zpracování pomocí PHP.

Výstup vznikl pro potřeby naší knihovny generovat náhodně seznamy ukázek a pro zobrazení náhledů obálek vybraných titulu sluzby DNNT - viz ukázka.

link: https://servis.obalkyknih.cz/export/dump/dnnt-okcz.cz.php.tgz
velikost soubor (plný export): 878.74 KB
datum posledního exportu: 2021-01-24 05:40:06
struktura pole - obálky PHP array:

"ID obálky" => "HODNOTA:uuid",

ukázka PHP pole - obálky:

            
"59128" => "uuid:28714680-6c72-11e2-bb2a-005056827e51",
"255870" => "uuid:cda69520-2d56-11e2-a8e5-005056827e52",
"269698" => "uuid:07e48b90-510d-11e3-ae59-005056827e52",
"280910" => "uuid:b48d5ad0-882f-11e3-bd09-005056827e51",

    );