CrossRef / rest-api-doc

Documentation for Crossref's REST API. For questions or suggestions, see https://community.crossref.org/
Other
735 stars 269 forks source link

Publication dates missing in works #5

Closed mudge closed 9 years ago

mudge commented 9 years ago

When filtering a member's works by pub-date (viz. using the from-pub-date and until-pub-date filter), I can't seem to find the actual publication date in the response.

For example, http://api.crossref.org/members/311/works?filter=type:journal-article,from-pub-date:2014-07-29,until-pub-date=2014-09-29 produces items like so:

{
    "subtitle": [
        "Mmp1a GIVES NEW INSIGHT INTO MMP FUNCTION"
    ],
    "subject": [
        "Physiology",
        "Cell Biology",
        "Clinical Biochemistry"
    ],
    "issued": {
        "date-parts": [
            [
                2014,
                8,
                27
            ]
        ]
    },
    "score": 1,
    "prefix": "http://id.crossref.org/prefix/10.1002",
    "author": [
        {
            "family": "Foley",
            "given": "Caitlin J."
        },
        {
            "family": "Kuliopulos",
            "given": "Athan"
        }
    ],
    "container-title": [
        "Journal of Cellular Physiology",
        "J. Cell. Physiol."
    ],
    "reference-count": 54,
    "page": "1875-1880",
    "deposited": {
        "date-parts": [
            [
                2014,
                8,
                29
            ]
        ],
        "timestamp": 1409270400000
    },
    "issue": "12",
    "title": [
        "Mouse Matrix Metalloprotease-1a (Mmp1a) Gives New Insight Into MMP Function"
    ],
    "type": "journal-article",
    "DOI": "10.1002/jcp.24650",
    "ISSN": [
        "0021-9541"
    ],
    "URL": "http://dx.doi.org/10.1002/jcp.24650",
    "source": "CrossRef",
    "publisher": "Wiley-Blackwell",
    "indexed": {
        "date-parts": [
            [
                2014,
                9,
                2
            ]
        ],
        "timestamp": 1409618270525
    },
    "volume": "229",
    "member": "http://id.crossref.org/member/311"
}

I see indexed, deposited and issued but no published?

kjw commented 9 years ago

Hi @mudge - issued is actually the published date. The reason I adopted this terminology is that it fits in with the CSL / citeproc JSON format - each record is actually a compatible superset of citeproc JSON that will work with CSL tools and the citeproc processors.

You can actually use from-issued-date and until-issued-date as synonyms for the publication date filters.

I'm going to add something to the docs to make all this clear.