Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use-case: retrieve e-print event summary information via JSON API #10

Open
erickpeirson opened this issue Jun 24, 2019 · 2 comments
Open
Labels
repository service Work related to the canonical repository service

Comments

@erickpeirson
Copy link
Contributor

erickpeirson commented Jun 24, 2019

As a developer, I should be able to write a client that can retrieve information about all of the versions and announcement events of an e-print using its identifier.

We need to implement the view described at https://github.com/arXiv/arxiv-canonical/tree/develop/repository#e-printidentifier .

The core of the implementation should be a controller function that takes a valid arXiv identifier. This should be implemented in https://github.com/arXiv/arxiv-canonical/blob/a7ef358c49fe68cae353919f489f636763879ec0/repository/repository/controllers.py

A route will also be required at https://github.com/arXiv/arxiv-canonical/blob/a7ef358c49fe68cae353919f489f636763879ec0/repository/repository/routes/api.py -- this can use the arxiv: converter (see also https://github.com/arXiv/arxiv-base/blob/3c516f4c3e83d9c242afe10efdad06de3d87b5d4/arxiv/base/converter.py#L9) that is registered by the arXiv Base package.

@erickpeirson erickpeirson added the repository service Work related to the canonical repository service label Jun 24, 2019
@erickpeirson erickpeirson changed the title Implement e-print event summary view as JSON API Use-case: retrieve e-print event summary information via JSON API Jun 24, 2019
@warpri81
Copy link
Collaborator

What fields need to be included in the overview?

@erickpeirson
Copy link
Contributor Author

At a minimum:

  • arxiv_id
  • announced_date of the first version
  • history (an array of all of the events related to the e-print)
  • versions (an array of objects that point to specific e-print versions). e.g.
"versions": [
    {
        "version": 1,
        "announced_date": ...,
        "submitted_date": ...,
        "url": ...    # API URL of the e-print version 
    }
]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
repository service Work related to the canonical repository service
Projects
None yet
Development

No branches or pull requests

2 participants