Categories
Bez kategorii

Join Publishers

We cordially invite the publishers of scientific journals and books to make their publications available in the Library of Science.

Our goal is to increase the visibility and availability of Polish scientific publications, which for publishers implies reaching new communities of readers and authors. The cooperation with us is free of charge and non-exclusive. We may host current as well as archival issues.

The Library of Science hosts over 1500 Polish scientific journals that yield a few hundred thousand articles altogether. We are well visible on the internet, our content is indexed by search engines and it is also easily available through a public API. For many users, ICM UW services, including the Library of Science, are a default starting place for searching for scientific content.

The platform allows to browse full-text resources originating from five thematic databases:

  • AGRO (journals on natural and agricultural sciences)
  • BazTech (journals in engineering and technology and exact sciences)
  • CEJSH (journals in humanities, social sciences, theology and arts)
  • DML-PL (journals in mathematics)
  • PSJD (journals in medical and health sciences).

The publications are made available in the Library of Science on the basis of contracts concluded by publishers with ICM UW. The contracts are mutually free of charge and non-exclusive, and as such they do not restrict publishers in their possibilities to make their content available elsewhere.

The representatives of publishers cooperating with ICM are given user accounts allowing them to access their publisher’s profile. Registered users also have access to the application allowing them to manage their publisher’s resources on the platform. It allows for automatization of metadata input (e.g., by importing from systems such as OJS) and simplifies work reporting (e.g., by downloading statistics and reports).

For our current and incoming users we offer free of charge training in technical, operational and legal issues of Open Access. We offer technical support in the input and editing of data and legal support in relation to the implementation of free licenses.

For inquiries about commencing cooperation please contact: lp.ik1652727632uanak1652727632etoil1652727632bib@y1652727632cwady1652727632w1652727632

Categories
Bez kategorii

Contact

The Library of Science is a service run by the Open Science Platform (PON) team operating as part of the Interdisciplinary Centre for Mathematical and Computational Modelling of the University of Warsaw.

Main page of the ICM UW: https://icm.edu.pl

Open Science Platform page: https://pon.edu.pl

Contact with the Open Science Platform team: lp.ud1652727632e.mci1652727632@nop1652727632

Contact in matters related to the use of the Library of Science: lp.ik1652727632uanak1652727632etoil1652727632bib@k1652727632sedpl1652727632eh1652727632

Contact for cooperation for publishers of scientific publications: lp.ik1652727632uanak1652727632etoil1652727632bib@y1652727632cwady1652727632w1652727632

Public Information Bulletin of the University of Warsaw:
https://uwedupl.bip.gov.pl/

Categories
Bez kategorii

Privacy and cookies policy

Cookies

We use cookies to run the Library of Science (more about cookies at: https://en.wikipedia.org/wiki/HTTP_cookie/). Using the Library of Science implies that they will be stored on your device. At any moment you may change the settings of your browser.

Types of cookies used by the Library of Science:

  • performance – collecting information about the way visitors use the service;
  • operational – necessary to service the registered users.

Third-party services that may be linked to in the Library of Science may use other cookies than indicated above. These services follow privacy policies specified by their administrators. Please make yourself acquainted with such policies after navigating to these sites.

The Library of Science stores http requests addressed to our server. The resources are identified by URL addresses. WWW server log files contain the following information:

  • public IP address of the computer that sent the request,
  • number of bytes sent by the server,
  • information about user’s browser,
  • information about time when the data was sent from the server.

The information does not contain data pertaining to user identity, but when aggregated with other information may constitute personal data. Therefore, the data controller subjects them to full protection available under the law on personal data.

The log files are retained for an unspecified period of time as an auxiliary material for administering the Library of Science. Their contents are not revealed to anyone except persons authorised to administer the Library of Science. Log files are used to generate statistics to help in administering.

Personal data of registered users – excerpt from the Library of Science – Terms of Use

  1. The personal data controller for the Users’ data is the University of Warsaw with its registered seat at Krakowskie Przedmieście 26/28, 00-927 Warszawa. Users may contact the data controller in one of the manners provided at: https://www.uw.edu.pl/kontakt/.
  2. The data controller has appointed a Data Protection Officer (DPO) who supervises the correct processing of personal data at the University of Warsaw. Users may only approach the DPO with matters related to the processing of personal data by the University of Warsaw. Users may contact the DPO via e-mail, by sending a message to: lp.ud1652727632e.wu.1652727632mda@d1652727632oi1652727632.
  3. The Users’ personal data will be processed for the purposes of providing the Library of Science services.
  4. The following personal data of the Users is processed as part of operating the Library of Science:
    1. login
    2. name and surname;
    3. email address;
    4. password in encrypted format;
    5. IP address;
    6. user role.
  5. Personal data is processed pursuant to Article 6 section 1 letters b, c, e and f of the Regulation of the European Parliament and of the Council (EU) 2016/679 of 27 April 2016 on the protection of natural persons with regard to the processing of personal data and on the free movement of such data, and repealing Directive 95/46/EC (General Data Protection Regulation; hereinafter referred to as GDPR). Data is processed for the time when the User has an account in the Library of Science and once it is removed – for the period of storing the data uploaded by the individual User into the Library of Science and for 5 years after their removal.
  6. Registered users, when using functions of the Library of Science related to uploading data, receive the following data of other Users: name, surname and login, while Users with administrative permissions also receive the email address.
  7. Personal data collected in the Library of Science may be transferred to third parties for the purposes required for the proper functioning of the Library of Science and only to the extent necessary. Data may also be made available to third parties in other cases specified by the law.
  8. A data subject has the right to (subject to the terms stipulated in the GDPR):
    1. obtain access to their data (Article 15 of the GDPR);
    2. rectify (correct) their data (Article 16 of the GDPR);
    3. delete their data (Article 17 of the GDPR);
    4. restrict the processing of their data (Article 18 of the GDPR);
    5. object to the processing of their data (Article 21 of the GDPR);
    6. withdraw their consent the processing of their data at any time (Article 7 of the GDPR);
    7. lodge a complaint with the President of the Personal Data Protection Office if they believe that the processing of their personal data violates the GDPR (Article 77 of the GDPR).
  9. Providing personal data by the User is necessary to register with the Library of Science. Refusal to provide data will result in the inability to use the resources of the Library of Science.
Categories
Bez kategorii

Library of Science – Terms of Use

§ 1. General provisions

  1. These Terms of Use govern the use of the electronic platform for scientific publications (“Library of Science”).
  2. The Library of Science is operated by the University of Warsaw – Interdisciplinary Centre for Mathematical and Computer Modelling (ICM) with its registered seat in Warsaw (00-927) at ul. Krakowskie Przedmieście 26/28, 00-927 Warszawa (“University”) via the Library of Science website (https://bibliotekanauki.pl).
  3. The purpose of the Library of Science is to make scientific papers and books („Scientific Publications”) available on the Internet.

§ 2. Rules for using the Library of Science

  1. The Library of Science service enables the following:
    1. storing Scientific Publications;
    2. making Scientific Publications publicly available;
    3. browsing Scientific Publications;
    4. downloading Scientific Publications.
  2. Browsing and downloading Scientific Publications is available in an open formula, free of charge to all those interested, subject to the terms of the applicable licenses.
  3. Users may use features available according to the current technical status of the Library of Science.
  4. Scientific Publications are stored and made publicly available under separate agreements concluded between the University and the publishers of these Scientific Publications, while using the related features requires registration in the Library’s electronic system.
  5. There are no special technical requirements for using the Library of Science, except for some of its specific features. Information about the current specific technical requirements is communicated on an ongoing basis in the Library of Science.

§ 3. Storing and making Scientific Publications publicly available

  1. A registered user may store and make Scientific Publications publicly available in the Library of Science.
  2. Users are forbidden to upload illegal content into the Library of Science, including, but not limited to storing and making available the following types of content in the Library of Science:
    1. contents to the dissemination of which the User does not hold a valid legal title;
    2. the dissemination of which breaches other third party rights, including their personal rights;
    3. the dissemination of which is contrary to other legal provisions than those resulting from sections 2.a and 2.b.
  3. By uploading metadata of Scientific Publications into the Library of Science, a User submits a statement that is in line with the contents of the Creative Commons 0 template, the full text of which is available at: https://creativecommons.org/publicdomain/zero/1.0/legalcode („CC0”). The scope of this statement only includes metadata but not the contents of the Scientific Publications.
  4. Files that contain the Scientific Publications may be made publicly available by the User for use by third parties under the applicable public domain provisions, fair use or other freedoms stipulated under the law, or under the provisions of a license selected by the User from the list available in the Library of Science.
  5. Metadata and full text versions of Scientific Publications uploaded by Users are subject to verification by administrators authorized by the University.
  6. Detailed matters related to storing and making Scientific Publications available in the Library of Science shall be stipulated in separate agreements between University and the publishers of these Scientific Publications.

§ 4. Complaints, queries and comments

  1. Complaints, queries and comments should be sent by registered mail to: Interdyscyplinarne Centrum Modelowania Matematycznego i Komputerowego, Uniwersytet Warszawski [Interdisciplinary Centre for Mathematical and Computer Modelling, University of Warsaw] ul. Tyniecka 15/17, 02-630 Warszawa or sent by electronic mail to lp.ik1652727632uanak1652727632etoil1652727632bib@k1652727632sedpl1652727632eh1652727632.
  2. The submission should provide sufficient details about the submitter, allowing for their identification, as well as the complaint, query or comment together with a short description of the issue.
  3. Submissions will be processed without unnecessary delay and submitters shall be notified of the results at the address indicated in their submission.

§ 5. Personal data and privacy policy

  1. The personal data controller for the Users’ data is the University of Warsaw with its registered seat at Krakowskie Przedmieście 26/28, 00-927 Warszawa. Users may contact the data controller in one of the manners provided at: https://www.uw.edu.pl/kontakt/.
  2. The data controller has appointed a Data Protection Officer (DPO) who supervises the correct processing of personal data at the University of Warsaw. Users may only approach the DPO with matters related to the processing of personal data by the University of Warsaw. Users may contact the DPO via e-mail, by sending a message to: lp.ud1652727632e.wu.1652727632mda@d1652727632oi1652727632.
  3. The Users’ personal data will be processed for the purposes of providing the Library of Science services.
  4. The following personal data of the Users is processed as part of operating the Library of Science:
    1. login
    2. name and surname;
    3. email address;
    4. password in encrypted format;
    5. IP address;
    6. user role.
  5. Personal data is processed pursuant to Article 6 section 1 letters b, c, e and f of the Regulation of the European Parliament and of the Council (EU) 2016/679 of 27 April 2016 on the protection of natural persons with regard to the processing of personal data and on the free movement of such data, and repealing Directive 95/46/EC (General Data Protection Regulation; hereinafter referred to as GDPR). Data is processed for the time when the User has an account in the Library of Science and once it is removed – for the period of storing the data uploaded by the individual User into the Library of Science and for 5 years after their removal.
  6. Registered users, when using functions of the Library of Science related to uploading data, receive the following data of other Users: name, surname and login, while Users with administrative permissions also receive the email address.
  7. Personal data collected in the Library of Science may be transferred to third parties for the purposes required for the proper functioning of the Library of Science and only to the extent necessary. Data may also be made available to third parties in other cases specified by the law.
  8. A data subject has the right to (subject to the terms stipulated in the GDPR):
    1. obtain access to their data (Article 15 of the GDPR);
    2. rectify (correct) their data (Article 16 of the GDPR);
    3. delete their data (Article 17 of the GDPR);
    4. restrict the processing of their data (Article 18 of the GDPR);
    5. object to the processing of their data (Article 21 of the GDPR);
    6. withdraw their consent the processing of their data at any time (Article 7 of the GDPR);
    7. lodge a complaint with the President of the Personal Data Protection Office if they believe that the processing of their personal data violates the GDPR (Article 77 of the GDPR).
  9. Providing personal data by the User is necessary to register with the Library of Science. Refusal to provide data will result in the inability to use the resources of the Library of Science.

§ 6. Liability

  1. The University undertakes best efforts to enable using the Library of Science without material downtimes or other interruptions, making it compatible with the largest number of possible hardware and software setups available in the market.
  2. If an official authority submits a notification or if credible information is obtained about the illegal nature of Scientific Publications or related activities, University shall immediately disable access to the indicated Scientific Publications in the Library of Science.
  3. The University may refuse to store and make Scientific Publications publicly available and may also block access or remove the data that does not constitute a Scientific Publications under the Terms and Conditions from the Library of Science, as well as data not complying with these Terms and Conditions. The University verifies the validity of metadata and technical validity of files.
  4. The University may refuse to register or remove the account of a User who breaches the Terms and Conditions and does not remedy the breach upon a 14-day notice.

§ 7. Modification of the Terms and Conditions

  1. The University shall inform the User of modifications to these Terms and Conditions by electronic mail sent to the addresses registered with the User’s account.
  2. A User that does not consent to modifications of these Terms and Conditions may request removal of their User account. These Terms and Conditions cease to bind the User from the date of removal of their account.
  3. A User who received information on a modification of the Terms and Conditions and did not demand their account to be removed at the earliest possible moment shall be bound by the modified Terms and Conditions.

§ 8. Final provision

Decisions of the Library of Science Team Head shall govern any matters not stipulated under these Terms and Conditions. Their decision may be appealed against to the Director of the Interdisciplinary Centre for Mathematical and Computer Modelling.

Categories
Bez kategorii

Declaration of Accessibility

The Library of Science Platform managed by the Interdisciplinary Centre for Mathematical and Computational Modelling of the University of Warsaw undertakes to ensure the accessibility of its website in accordance with the provisions of the Act of 4 April 2019 on the Digital Accessibility of Websites and Mobile Applications of Public Entities. The accessibility statement applies to the website https://bibliotekanauki.pl and https://editor.bibliotekanauki.pl and their subpages.

Website publication date: 2020-11-30

Date of last significant update: 2021-01-13

Compliance status

The website complies with the Act on Digital Accessibility of Websites and Mobile Applications of Public Entities at the level of WCAG 2.1. AAA, with the following exceptions:

  • some images do not have an alternative text,
  • some elements that open the link in a new window/tab of the web browser do not inform about it,
  • the page has links highlighted only by an underline,
  • some PDF files were created on the basis of poorly prepared Word documents (there is no well-marked logical structure, tags), or are scans of documents. The way of adding publications in the system reduces such practices to a minimum, however the website is supplemented on a daily basis by a large group of editors and publishers who do not always format files correctly. ICM administrators make every effort to ensure that new documents are prepared correctly.
  • documents that are unreadable by screen readers can be recognized with the OCR tool.

Preparation of the accessibility declaration

The declaration was made on: 2021-01-14.

The declaration was drawn up on the basis of self-assessment by a public body.

Keyboard shortcuts

You can use standard keyboard shortcuts on the website.

Feedback and contact details

In case of problems with the accessibility of the website, please contact the managing authority – the Interdisciplinary Centre for Mathematical and Computational Modelling of the University of Warsaw (e-mail: lp.ik1652727632uanak1652727632etoil1652727632bib@k1652727632sedpl1652727632eh1652727632, phone no.: (22) 874 91 00). In the same way, you can submit requests for access to information that is not available and complain about the lack of accessibility.

Everyone has the right to request the digital accessibility of a website, mobile application or any element thereof. You can also request information through an alternative means of access, such as reading a digitally inaccessible document, describing the content of a movie without audio description, etc. The request should contain the details of the person making the request, an indication of which website or mobile application is meant and the method of contact. Where the requesting person requests information by an alternative means of access, the person should also specify a manner in which the information is to be presented that is convenient for the person. The public entity should comply with the request immediately, no later than within 7 days from the date of the request. If it is not possible to meet this deadline, the public entity shall immediately inform the requester when it will be possible to comply with the request, but this period may not be longer than 2 months from the date of the request. Where it is not possible to ensure digital accessibility, a public body may propose an alternative way of accessing the information. In the event that a public entity refuses to comply with a request for accessibility or an alternative means of access to information, the requester may lodge a complaint about the digital accessibility of a website, mobile application or element of a website or mobile application. Once the above procedure has been used, the person can also submit a request to the Ombudsman.

Categories
Bez kategorii

API OAI-PMH Documentation

API OAI-PMH

Introduction

The platform provides three data repositories compliant with the OAI-PMH specification, one for each type of publication:

These repositories respond to HTTP requests like GET and POST and return responses like text/xml.
Each request to the repository must contain the parameter verb, which determines the type of response.

Identify

The request with the parameter verb with value Identify lets you get basic information about the repository, such as its name, how deleted records are handled, date granulation, ID format, and more. Such requests do not require any additional parameters.

Example

  • URL: https://bibliotekanauki.pl/api/oai/articles?verb=Identify
  • Response:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T00:01:20.579837Z</responseDate>
    <request verb="Identify">https://bibliotekanauki.pl/api/oai/articles</request>
    <Identify>
        <repositoryName>Biblioteka Nauki - repozytorium artykułów</repositoryName>
        <baseURL>https://bibliotekanauki.pl/api/oai/articles</baseURL>
        <protocolVersion>2.0</protocolVersion>
        <adminEmail>lp.ik1652727632uanak1652727632etoil1652727632bib@n1652727632imda1652727632</adminEmail>
        <earliestDatestamp>1990-02-01T12:00:00Z</earliestDatestamp>
        <deletedRecord>persistent</deletedRecord>
        <granularity>YYYY-MM-DD</granularity>
        <description>
            <oai-identifier xmlns="http://www.openarchives.org/OAI/2.0/oai-identifier"
                            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                            xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai-identifier http://www.openarchives.org/OAI/2.0/oai-identifier.xsd">
                <scheme>oai</scheme>
                <repositoryIdentifier>bibliotekanauki.pl</repositoryIdentifier>
                <delimiter>:</delimiter>
                <sampleIdentifier>oai:bibliotekanauki.pl:234</sampleIdentifier>
            </oai-identifier>
        </description>
        <description>
            <friends xmlns="http://www.openarchives.org/OAI/2.0/friends/"
                     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                     xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/friends/ http://www.openarchives.org/OAI/2.0/friends.xsd">
                <baseURL>https://bibliotekanauki.pl/api/oai/books</baseURL>
                <baseURL>https://bibliotekanauki.pl/api/oai/chapters</baseURL>
            </friends>
        </description>
    </Identify>
    </OAI-PMH>
    

ListMetadataFormats

The request with the parameter verb with value ListMetadataFormats provides the information about the supported metadata formats. The articles repository provides records in the following formats:

  • DublinCore compliant with the requirements of the OpenAire project
  • JATS
  • BWMETA

In the books repository and in chapters the JATS (Journal Article Tag Suite) format has been replaced with BITS (Book Interchange Tag Set) format. The requests ListMetadataFormats do not require any additional parameters.

Example

  • URL: https://bibliotekanauki.pl/api/oai/articles?verb=ListMetadataFormats
  • Response:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T00:01:20.579837Z</responseDate>
    <request verb="ListMetadataFormats">https://bibliotekanauki.pl/api/oai/articles</request>
    <ListMetadataFormats>
        <metadataFormat>
            <metadataPrefix>oai_openaire</metadataPrefix>
            <schema>https://www.openaire.eu/schema/repo-lit/4.0/openaire.xsd</schema>
            <metadataNamespace>http://namespace.openaire.eu/schema/oaire/</metadataNamespace>
        </metadataFormat>
        <metadataFormat>
            <metadataPrefix>jats</metadataPrefix>
            <schema>https://jats.nlm.nih.gov/archiving/1.2/xsd/JATS-archivearticle1.xsd</schema>
            <metadataNamespace>http://jats.nlm.nih.gov</metadataNamespace>
        </metadataFormat>
        <metadataFormat>
            <metadataPrefix>bwmeta</metadataPrefix>
            <schema>http://yadda.icm.edu.pl/bwmeta-2.1.0.xsd</schema>
            <metadataNamespace>http://yadda.icm.edu.pl</metadataNamespace>
        </metadataFormat>
    </ListMetadataFormats>
    </OAI-PMH>
    

ListSets

The request with the parameter verb with value ListSets allows you to get information about the hierarchy of collections in the specified repository. Currently the collections are supported only in the articles repository. The request ListSets in this repository responds with a flat hierarchy of collection, each set corresponding with one journal. Other repositories do not support sets – the functionality of the sets is described as optional in the OAI-PMH specification – and current implementation responds with the appropriate error code (noSetHierarchy). This situation may change in the future.

Example

  • URL: https://bibliotekanauki.pl/api/oai/articles?verb=ListSets
  • Response:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T00:01:20.579837Z</responseDate>
    <request verb="ListSets">https://bibliotekanauki.pl/api/oai/articles</request>
    <ListSets>
        <set>
            <setSpec>1</setSpec>
            <setName>Prace Instytutu Badawczego Leśnictwa</setName>
        </set>
        <set>
            <setSpec>2</setSpec>
            <setName>Innowacyjne Mleczarstwo</setName>
        </set>
        <set>
            <setSpec>3</setSpec>
            <setName>Diagnostyka Laboratoryjna</setName>
        </set>
    
        <!-- Remaining records... -->
    
    </ListSets>
    </OAI-PMH>
    
  • URL: https://bibliotekanauki.pl/api/oai/books?verb=ListSets

  • Response:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T00:01:20.579837Z</responseDate>
    <request verb="ListSets">https://bibliotekanauki.pl/api/oai/books</request>
    <error code="noSetHierarchy">The repository does not support sets.</error>
    </OAI-PMH>
    

ListRecords

The request with the parameter verb with value ListRecords downloads the record list with their full metadata in the format indicated with the parameter metadataPrefix. The deleted records are listed in the response only in the form of heading, without the metadata. The parameter metadataPrefix is required and must take one of the values listed in request response tags “ ListMetadataFormats.

Example

  • URL: https://bibliotekanauki.pl/api/oai/articles?verb=ListRecords&metadataPrefix=jats
  • Response:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T00:01:20.579837Z</responseDate>
    <request metadataPrefix="jats" verb="ListRecords">https://bibliotekanauki.pl/api/oai/articles</request>
    <ListRecords>
        <record>
            <header>
                <identifier>oai:bibliotekanauki.pl:105</identifier>
                <datestamp>2020-12-09T23:17:11.424Z</datestamp>
            </header>
            <metadata>
                 <!-- Metadata in selected format... -->
            </metadata>
        </record>
        <record>
            <header status="deleted">
                <identifier>oai:bibliotekanauki.pl:107</identifier>
                <datestamp>2020-12-09T23:17:12.235Z</datestamp>
            </header>
        </record>
    
        <!-- Remaining records... -->
    
    </ListRecords>
    </OAI-PMH>
    

ListIdentifiers

The request with the parameter verb with value ListIdentifiers works like ListRecords, but downloads only headers of the records, without the metadata. The parameter metadataPrefix is required and must take one of the values listed in the indication response to request tags “ ListMetadataFormats.

Example

  • URL: https://bibliotekanauki.pl/api/oai/articles?verb=ListIdentifiers&metadataPrefix=jats
  • Response:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T00:01:20.579837Z</responseDate>
    <request metadataPrefix="jats" verb="ListIdentifiers">https://bibliotekanauki.pl/api/oai/articles</request>
    <ListRecords>
        <record>
            <header>
                <identifier>oai:bibliotekanauki.pl:105</identifier>
                <datestamp>2020-12-09T23:17:11.424Z</datestamp>
            </header>
        </record>
        <record>
            <header status="deleted">
                <identifier>oai:bibliotekanauki.pl:107</identifier>
                <datestamp>2020-12-09T23:17:12.235Z</datestamp>
            </header>
        </record>
    
        <!-- Remaining records... -->
    
    </ListRecords>
    </OAI-PMH>
    

GetRecord

The request with parameter verb with value GetRecord returns information about the record with specific ID. The following parameters are required:

  • metadataPrefix – format of the metadata; must take one of the values listed in the indicators response to request tags “
    ListMetadataFormat,
  • identifier – record ID

Example

  • URL: https://bibliotekanauki.pl/api/oai/articles?verb=GetRecord&metadataPrefix=jats&identifier=oai:bibliotekanauki.pl:202060
  • Response:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-31T22:40:01.254200Z</responseDate>
    <request identifier="oai:bibliotekanauki.pl:202060" metadataPrefix="jats" verb="GetRecord">
        https://bibliotekanauki.pl/api/oai/articles
    </request>
    <GetRecord>
        <record>
            <header>
                <identifier>oai:bibliotekanauki.pl:202060</identifier>
                <datestamp>2021-01-28T18:00:26.736Z</datestamp>
            </header>
            <metadata>
                <article xmlns:xlink="http://www.w3.org/1999/xlink"
                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://jats.nlm.nih.gov"
                         xsi:schemaLocation="http://jats.nlm.nih.gov https://jats.nlm.nih.gov/archiving/1.2/xsd/JATS-archivearticle1.xsd">
                    <front>
                        <journal-meta>
                            <journal-title-group>
                                <journal-title>Bulletin of the Polish Academy of Sciences. Technical Sciences
                                </journal-title>
                            </journal-title-group>
                            <issn pub-type="ppub">0239-7528</issn>
                            <publisher>
                                <publisher-name>Polska Akademia Nauk. Czytelnia Czasopism PAN</publisher-name>
                            </publisher>
                        </journal-meta>
                        <article-meta>
                            <article-categories>
                                <subj-group>
                                    <subject>Engineering and technical sciences</subject>
                                    <subj-group>
                                        <subject>mechanical engineering</subject>
                                    </subj-group>
                                </subj-group>
                            </article-categories>
                            <title-group>
                                <article-title xml:lang="en">Calculations of transport parameters in semiconductor superlattices based on the Greens’ functions method in different Hamiltonian representations</article-title>
                            </title-group>
                            <article-id pub-id-type="doi">10.24425/bpasts.2019.129661</article-id>
                            <contrib-group>
                                <contrib>
                                    <name name-style="western">
                                        <surname>Mączka</surname>
                                        <given-names>M.</given-names>
                                    </name>
                                    <role>author</role>
                                    <xref ref-type="aff" rid="aff-202060-0"></xref>
                                </contrib>
                                <contrib>
                                    <name name-style="western">
                                        <surname>Hałdaś</surname>
                                        <given-names>G.</given-names>
                                    </name>
                                    <role>author</role>
                                    <xref ref-type="aff" rid="aff-202060-0"></xref>
                                </contrib>
                            </contrib-group>
                            <aff id="aff-202060-0">
                                <institution content-type="orgname">Department of Electronics Fundamentals, Rzeszów University of Technology, W. Pola 2, 35-959 Rzeszów, Poland</institution>
                            </aff>
                            <pub-date>
                                <year>2019</year>
                            </pub-date>
                            <abstract xml:lang="en">
                                <p>Two methods for calculating transport parameters in semiconductor superlattices by applying Green’s functions are compared in the paper. For one of the methods, the Wannier functions method, where computations in the complex space and Wannier functions base are required, the Hamiltonian matrix is small in size and its elements depend solely on the energy. For the real space method, as it operates in the floating point domain and uses the Hamiltonian containing the elements dependent both on energy and position, the Hamiltonian matrix is larger in size. The size makes the method computationally challenging. To find the consequences of choosing one of the methods, a?direct comparison between the computations, obtained for both methods with the same input parameters, was undertaken. The differences between the results are shown and explained. Selected simulations allowed us to discuss advantages and disadvantages of both methods. The calculations include transport parameters such as the density of states and the occupation functions, with regard to scattering processes where the self-consistent Born approximation was used, as well as the spatial distribution of electron concentration for two superlattices structures. The numerical results are obtained within the non-equilibrium Green’s functions formalism by solving the Dyson and the Keldysh equations.</p>
                            </abstract>
                            <volume>67</volume>
                            <issue>3</issue>
                            <issue-id>11320</issue-id>
                            <fpage>631</fpage>
                            <lpage>641</lpage>
                            <kwd-group xml:lang="en">
                                <kwd>semiconductor superlattices</kwd>
                                <kwd>NEGF formalism</kwd>
                                <kwd>Wannier functions</kwd>
                            </kwd-group>
                            <kwd-group xml:lang="pl">
                                <kwd>nadprzewodnik</kwd>
                                <kwd>półprzewodnik</kwd>
                                <kwd>Formalizm</kwd>
                                <kwd>funkcja Wanniera</kwd>
                            </kwd-group>
                            <self-uri xlink:href="https://3pn.icm.edu.pl/api/full-texts/2020/12/10/086565f1-13e0-40cb-8108-9eb9d85e5d7f.pdf" content-type="application/pdf"></self-uri>
                        </article-meta>
                    </front>
                </article>
            </metadata>
        </record>
    </GetRecord>
    </OAI-PMH>
    

Paging results (resumption token)

In the situation when the number of records that meet request conditions ListRecords, ListIdentifiers or ListSets is higher than the maximum number of records supported in one response, this response will contain the resumption token, which has to be used for the next request. The result of this request will be another part of data that meets the conditions. This step has to be taken until the response will not contain the resumption token.

Parameter resumptionToken is the exclusive type, which means that it has to appear in the request independently. Using the other parameters along with resumptionToken is forbidden. This limitation does not apply to the parameter verb, which must be a part of every request sent to API.

Example

  • We make the first request ListRecords
    • URL: https://bibliotekanauki.pl/api/oai/articles?verb=ListRecords&metadataPrefix=jats
  • We receive the response with part of the records that meet the request conditions and with the value resumptionToken:
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T22:05:03.984324Z</responseDate>
    <request metadataPrefix="jats" verb="ListRecords">http://bibliotekanauki.pl/api/oai/articles</request>
    <ListRecords>
        <record><!-- record data --></record>
        <record><!-- record data --></record>
        <record><!-- record data --></record>
        <!-- ... -->
        <resumptionToken expirationDate="2021-01-01T23:05:03.978Z">
            eyJ0eXAiOiJKV1QiLCJhbGciOiJub25lIn0.eyJtZXRhZGF0YVByZWZpeCI6ImphdHMiLCJleHAiOjE2MTIxMzQzMDMsImlhdCI6MTYxMjEzMDcwMywic3RhcnRpbmdJZCI6MTY2Mn0.
        </resumptionToken>
    </ListRecords>
    </OAI-PMH>
    
  • We make another request ListRecords, this time adding the parameter resumptionToken.
    • URL: https://bibliotekanauki.pl/api/oai/articles?verb=ListRecords&resumptionToken=eyJ0eXAiOiJKV1QiLCJhbGciOiJub25lIn0.eyJtZXRhZGF0YVByZWZpeCI6ImphdHMiLCJleHAiOjE2MTIxMzQzMDMsImlhdCI6MTYxMjEzMDcwMywic3RhcnRpbmdJZCI6MTY2Mn0.
  • We receive another part of the data and without the token, which means there is no more data that meet the request conditions.
    <?xml version="1.0" ?>
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
    <responseDate>2021-01-01T22:05:08.435765Z</responseDate>
    <request metadataPrefix="jats" verb="ListRecords">http://bibliotekanauki.pl/api/oai/articles</request>
    <ListRecords>
        <record><!-- record data --></record>
        <record><!-- record data --></record>
        <resumptionToken></resumptionToken>
    </ListRecords>
    </OAI-PMH>
    

Limit the collection of downloaded data (selective harvesting)

The repositories allow to limit the set of data downloaded with the requests ListRecords and ListIdentifiers to data made, modified or deleted in the certain period of time. The parameters from and untilare used for this. These parameters take values in the format defined in the request response tag “ Identify.

Both limitations (inclusive), therefore:

  • Value from needs to be interpreted greater than or equal to,
  • Value until needs to be interpreted less than or equal to.

The articles repository can as well limit the set of data to articles from a certain journal with the parameter set (see chapter ListSets).

Example

  • The headings of the made, modified or deleted records from 1st of January 2019:
    • https://bibliotekanauki.pl/api/oai/articles?verb=ListIdentifiers&metadataPrefix=jats&from=2019-01-01
  • The headings made, modified or deleted until 2nd of December 2020:
    • https://bibliotekanauki.pl/api/oai/articles?verb=ListIdentifiers&metadataPrefix=jats&until=2020-12-02
  • Records made, modified or deleted from 1st of January 2021 and 1st of February 2021:
    • https://bibliotekanauki.pl/api/oai/articles?verb=ListRecords&metadataPrefix=jats&from=2021-01-01&until=2021-02-01
  • The headings of the records made, modified or deleted from 1st of January 2019 from the journal with the set of ID 2:
    • https://bibliotekanauki.pl/api/oai/articles?verb=ListRecords&metadataPrefix=jats&from=2019-01-01&set=2

Errors

API returns the following errors:

  • badArgument – The request includes invalid parameters, the requested parameter is missing, the parameter occurs repeatedly, or the value of the parameter is invalid.
  • badResumptionToken – the value of the parameter resumptionToken is invalid or the token is invalid.
  • badVerb – the value of the parameter verb is invalid, the parameter occurs repeatedly or does not occur at all.
  • cannotDisseminateFormat – the indicated metadata format is not supported by the repository.
  • idDoesNotExist – Record of the indicated ID does not occur in the repository.
  • noRecordsMatch – no records that meet the conditions defined with parameters from and until.
  • noSetHierarchy – the repository does not support sets.

Additional resources

Categories
Bez kategorii

API Documentation

As part of the project, there were three types of API documentation created:

  • authentication – used to verify users and grant them access rights
  • editing – allowing access to the functions of the application module for managing platform resources
  • repository – used to query the repository for publications, access to repository functions via OAI-PMH and REST protocols.

Authentication and Editing API Documentation

Repository API Documentation

Categories
Bez kategorii

Embedding Library of Science on your own webpage

The Library of Science provides easy, sustainable and free access to scientific publications with their metadata. Using the Library of Science does not require creating an account or installing any special software. Articles are made available as PDF files, and books are also available in PDF as well as in other formats such as EPUB, MOBI oraz XML.

A direct link on your website will contribute to the promotion of Polish science, journals and authors, and will also be useful for academic staff and students looking for valuable scientific literature.

You do not have to restrict yourself to adding only a static text with a link to our Platform on your webpage. Our API allows You to embed the dynamic information, i.e., automatically updated lists of publications selected to meet prescribed criteria.

This mechanism works similarly to embedding e.g., a YouTube player on your own website and consists in placing the following fragment in the code of these pages:

<script src=”https://bibliotekanauki.pl/embedded.js?type=latest&publications=articles&publisher=123&limit=10&nonce=abc”>
* </script>

The above script will show on your page the list of the latest 10 articles available in the Library of Science, published by the Publisher with the specified ID. You can choose from:

  • the latest or most popular (type=latest or type=popular, the latest by default),
  • the type of the publication: articles, journals or books (publications=articles, publications=journals or publications=books, articles by default),
  • showing only certain publisher (publisher=123, the ID of the publisher can be found on webpage https://bibliotekanauki.pl/publishing-companies, where the link to the information about every publisher is shown as a number of the said publisher, like for example for publisher: Czytelnik it is 719 – https://bibliotekanauki.pl/publishing-companies/719; without this number the data will be collected for every publisher),
  • number of publications (limit), by default: 3, max 15,
  • the “nonce” parameter is also available, which can be useful to webmasters for more advanced use of the script

Example of using the list: