New Zealand Research Information System (NZRIS) Application Programming Interface (API) Specification
NZRIS will be a national, online hub of information about research, science and innovation in New Zealand. You can find more about the NZRIS project at https://www.mbie.govt.nz/science-and-technology/science-and-innovation/research-and-data/nzris/. This repository contains part of the full descrition of the NZRIS API which will provide a way for organisations to submit data to NZRIS. The full description is publically available on the Ministry of Business, Innovation and Employment (MBIE) website.
Data needs to be submitted to the API in JavaScript Object Notation (JSON). There is a structure set by the 'Swagger definition' which is a script written in YAML that dictates how the API is to operate. This definition is available in api-definition.yaml, and viewable with the Swagger Editor (see below). The JSON input format comes from this definition and an example created with the Swagger Editor based on the definition is available as submission-example.json.
The Swagger Editor provides a way to easily veiw Swagger YAML definitions. To view the definition for the NZRIS project:
- Go to https://editor.swagger.io/.
- Copy the text from the API definition.
- Paste the copied text into the left hand side of the Swagger Editor.