The TNRS API is in the early stages of development. Currently it consists of a single service to which a list of names is submitted.
Use GET to call to the matchNames service, found at: http://tnrs.iplantc.org/tnrsm-svc/matchNames
Easy ways to submit names to the service include entering a query in your web browser or using the Linux curl tool.
Two parameters are required:
- retrieve specifies whether to retrieve all matches for the names submitted. There are currently two options: retrieve=best retrieves only the single best match for each name submitted; retrieve=all retrieves all matches.
- names is followed by a comma separated list of names being submitted. Spaces in names must be url-encoded.
Here is a short example in which the best matches are requested for four names:
Output is currently returned in JSON format. The service will be expanded soon to support output in XML and CSV as well. In addition, parameters will be added soon to specify output format, encoding, and compression of the results.
All source code is available in our GitHub repository
We built on two existing open source projects, each of which retain their original licensing.