Connecting Zotero

[pkiraly]

As a user I would like to connect to Zotero (https://www.zotero.org/) as well the same way as I could connect to BibSonomy.

The top level Zotero API documentation is available at https://www.zotero.org/support/dev/web_api/v3/start.
The write API documentation is available at https://www.zotero.org/support/dev/web_api/v3/write_requests

[pkiraly]

Zotero supports a couple of item types. The list can be download via

GET /itemTypes

[
    {"itemType": "artwork", "localized": "Artwork"},
    {"itemType": "audioRecording", "localized": "Audio Recording"},
    {"itemType": "bill", "localized": "Bill"},
    {"itemType": "blogPost", "localized": "Blog Post"},
    {"itemType": "book", "localized": "Book"},
    {"itemType": "bookSection", "localized": "Book Section"},
    {"itemType": "case", "localized": "Case"},
    {"itemType": "computerProgram", "localized": "Computer Program"},
    {"itemType": "conferencePaper", "localized": "Conference Paper"},
    {"itemType": "dictionaryEntry", "localized": "Dictionary Entry"},
    {"itemType": "document", "localized": "Document"},
    {"itemType": "email", "localized": "E-mail"},
    {"itemType": "encyclopediaArticle", "localized": "Encyclopedia Article"},
    {"itemType": "film", "localized": "Film"},
    {"itemType": "forumPost", "localized": "Forum Post"},
    {"itemType": "hearing", "localized": "Hearing"},
    {"itemType": "instantMessage", "localized": "Instant Message"},
    {"itemType": "interview", "localized": "Interview"},
    {"itemType": "journalArticle", "localized": "Journal Article"},
    {"itemType": "letter", "localized": "Letter"},
    {"itemType": "magazineArticle", "localized": "Magazine Article"},
    {"itemType": "manuscript", "localized": "Manuscript"},
    {"itemType": "map", "localized": "Map"},
    {"itemType": "newspaperArticle", "localized": "Newspaper Article"},
    {"itemType": "note", "localized": "Note"},
    {"itemType": "patent", "localized": "Patent"},
    {"itemType": "podcast", "localized": "Podcast"},
    {"itemType": "presentation", "localized": "Presentation"},
    {"itemType": "radioBroadcast", "localized": "Radio Broadcast"},
    {"itemType": "report", "localized": "Report"},
    {"itemType": "statute", "localized": "Statute"},
    {"itemType": "tvBroadcast", "localized": "TV Broadcast"},
    {"itemType": "thesis", "localized": "Thesis"},
    {"itemType": "videoRecording", "localized": "Video Recording"},
    {"itemType": "webpage", "localized": "Web Page"}
]

[pkiraly]

Zotero also provides a data template for every types, here is for books:

GET /items/new?itemType=book

{
    "itemType": "book",
    "title": "",
    "creators": [
        {
            "creatorType": "author",
            "firstName": "",
            "lastName": ""
        }
    ],
    "abstractNote": "",
    "series": "",
    "seriesNumber": "",
    "volume": "",
    "numberOfVolumes": "",
    "edition": "",
    "place": "",
    "publisher": "",
    "date": "",
    "numPages": "",
    "language": "",
    "ISBN": "",
    "shortTitle": "",
    "url": "",
    "accessDate": "",
    "archive": "",
    "archiveLocation": "",
    "libraryCatalog": "",
    "callNumber": "",
    "rights": "",
    "extra": "",
    "tags": [],
    "collections": [],
    "relations": {}
}

[pkiraly]

Here is a spreadsheet which maps YetAnotherBibliographicalItem and different Zotero items.

https://docs.google.com/spreadsheets/d/1_F5cpFMVO27pOc61XhUToO0BygXsX2G2yxHil5nVy8I/edit?usp=sharing

The semantics of some of the fields are not clear, so we should add some more clarification on the meaning of the fields.