Ben Abrahamse, Chair of the Standing Committee on Applications, has agreed to convene and coordinate this subgroup activity. The API review/testing group will be a collaboration between interested members of SCA and any of the ISNI pilot participants. A technical contact from ISNI will also participate as needed.
Members: Alison Thornton, Amber Billey, Christine Fernsebner Eslao, Isabel Quintana, Lucas Mak, Susan Radovsky, Vitus Tang
The group began its work in October 2017 and anticipates completing its work by the first week in February.
Activities and deliverables include:
- Review ISNI API documentation to learn functionality and gaps. For members there are two ISNI APIs :
- SRU Search API for members
- The AtomPub API: the AtomPub API allows members and RAG’s to submit ISNI requests using the ISNI Request schema.
- Test functionality according to varied use cases
- Determine ease of use and identify support or additional documentation that would be necessary for PCC members availing themselves of this self-service model
- Identify and prioritize development roadmap for ISNI for maximum benefit of API interaction with ISNI
- Document lessons learned, activities that require attention by other
- Review ISNI API documentation to learn functionality and gaps. For members there are two ISNI APIs :
ISNI API relevant documentation
Search
ISNI documention: http://www.isni.org/content/documents-related-database-enquiry
Suggested starting point: ISNI SRU Search API: Guidelines and Examples
The Search API is using the SRU standard, version 1.1 and is also available to the general public.
An interface for constructing complex queries is provided at: http://isni.oclc.org/sru/DB=1.2/
(If using a web browser to view results, view page source to see XML output. In most browsers, you can access this by right-clicking on the page you're viewing and choosing "view page source" from the right-click menu.)
Submission
ISNI documentation: http://www.isni.org/content/documents-related-data-submission
Suggested starting point: ISNI Atom Pub API guidelines.pdf
The AtomPub API submits single requests at a time, but could be programmed at a local level to automate submission of sequential requests as a way to make it a batch process.
