{"type":"doc","content":[{"type":"paragraph","content":[{"text":"v1.0, June 2015 (Main documentation for the NSL API version 1.0)","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"5a957edf81aace43dd9f43dab2a7cdd1"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"da9bc617-a3fc-4f47-8d3e-6cca761e8cb0"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Introduction","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1.1. Australian Plant Name Index (APNI)","type":"text"}]},{"type":"paragraph","content":[{"text":"APNI is a database for the botanical community that deals with the names of Australian plants and their usage in the scientific literature, whether as a current name or synonym. ","type":"text"},{"text":"APNI does not recommend any particular taxonomy or nomenclature.","type":"text","marks":[{"type":"strong"}]},{"text":" For a listing of currently accepted scientific names for the Australian vascular flora, see the Australian Plant Census (APC). Information available from APNI includes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Scientific plant names;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Author details;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Original publication details (protologue), with links to a PDF in some cases via a PDF icon","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subsequent usage of the name in the scientific literature (in an Australian context)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Typification details;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An APC tick showing which, if any, concept has been accepted for the APC","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"State distribution (from the Australian Plant Census (APC));","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Relevant comments and notes;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Links to other information such as plant distributions, descriptions and images search via a picture search icon.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"APNI is maintained at the Centre for Australian National Biodiversity Research with staff, resources and financial support from the Australian National Herbarium, Australian National Botanic Gardens and the Australian Biological Resources Study. The CANBR, ANBG and ABRS collaborate to further the updating and delivery of APNI and APC.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1.2. Australian Plant Census (APC)","type":"text"}]},{"type":"paragraph","content":[{"text":"APC is a database of the accepted scientific names for the Australian vascular flora, ferns, gymnosperms, hornworts and liverworts, both native and introduced, and lists synonyms and misapplications for these names. The APC will cover all published scientific plant names used in an Australian context in the taxonomic literature, but excludes taxa known only from cultivation in Australia. The taxonomy and nomenclature adopted for the APC are endorsed by the Council of Heads of Australasian Herbaria (CHAH).","type":"text"}]},{"type":"paragraph","content":[{"text":"For further information about names listed in APC, including bibliographic information, secondary references and typification, consult the Australian Plant Name Index (APNI). Alternatively, clicking on hyperlinked names in APC search results will link to the APNI data for any given name.","type":"text"}]},{"type":"paragraph","content":[{"text":"Information available through APC includes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Accepted scientific name and author abbreviation(s);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reference to the taxonomic and nomenclatural concept adopted for APC;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Synonym(s) and misapplications;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"State distribution;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Relevant comments and notes","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"APC is coordinated through a network of contributors, and is maintained by the Centre for Australian National Biodiversity Research with staff, resources and financial support from the Australian National Herbarium, Australian National Botanic Gardens, Australian Biological Resources Study, CHAH and State and Territory herbaria. These organisations collaborate to further the updating and delivery of APC.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1.3. National Species List (NSL)","type":"text"}]},{"type":"paragraph","content":[{"text":"The National Species List is a complete database covering vascular plants, mosses, fungi, animals etc. The data for the NSL is kept in disparate systems that are combined under the NSL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The current NSL infrastructure does this via RDF web services over some semi static datasets, \"but that is changing.\" What you see here is the start of the new NSL infrastructure that allows the separatly governed datasets to be curated by their \"owners\" while combining them into a live discoverable, searchable data resource with a consistent modern interface.","type":"text"}]},{"type":"paragraph","content":[{"text":"The new infrastructure takes the existing datasets and makes them \"shards\" of the NSL. Each shard will be imported separately into the new system as resources allow.","type":"text"}]},{"type":"paragraph","content":[{"text":"The new system incorporates an improved editing system and separate distributed search services, including linked data services.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"1.3.1. What we have now","type":"text"}]},{"type":"paragraph","content":[{"text":"We have migrated","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"APNI and APC","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mosses (AusMoss)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lichens (ABRS)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"data into NSL \"shards\".","type":"text"}]},{"type":"paragraph","content":[{"text":"The NSL services including search and the RDF/SPARQL interfaces are available via ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://biodiversity.org.au/nsl"}},{"text":" .","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"1.3.2. The road map","type":"text"}]},{"type":"paragraph","content":[{"text":"We will be adding new shards to the system as we go, with the likely priority as:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fungi","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Algae","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mosses","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lichen","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the Australian Faunal Directory","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"As we add datasets, improvements to the editor and services will be required to cater for differing requirements, these changes will be incorporated based on priorities and resources.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Using the NSL","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.1. Searching the NSL","type":"text"}]},{"type":"paragraph","content":[{"text":"The current NSL service includes the APNI and APC data. APNI is a nomenclator, it includes a list of names of vascular plants and where they have been used in references. In this sense, APNI has no opinion about the name, it just states where and how it has been used in a reference.","type":"text"}]},{"type":"paragraph","content":[{"text":"APC is a consensus-based classification, it provides an opinion about what is the accepted name, and where the taxon sits in the classification \"tree\".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"What is a tree?","type":"text"}]},{"type":"paragraph","content":[{"text":"We may speak of \"trees\" when referring to classifications in the NSL system, which shouldn’t be confused with actual woody vascular plants. A tree in this sense is the structure of set of names: where one name is in relation to other names. For example, the plant family name is \"above\" the names of its constituent genera, a genus name ranks \"below\" the family in the tree. A family may contain many genera and each genus many species and so on.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"When you look at the NSL services page you will see the APNI and APC \"products\" as links in the \"Navigation Bar\" at the top of the page. To search APNI click the APNI link.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":884,"id":"dc9efcda-8fd9-483c-9b64-1d68f470ddad","collection":"contentId-1380483087","type":"file","height":595}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 1. The NSL Services page (APNI product)","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The search page consists of a set of search forms that can be found by selecting the appropriate tab.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.1.1. Name Search","type":"text"}]},{"type":"paragraph","content":[{"text":"By default when you go to the search page you are on the \"Name Search\" tab. This gives you a simple text box to enter a search for the name or names you are looking for.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This search ","type":"text"},{"text":"just looks at the full name text,","type":"text","marks":[{"type":"strong"}]},{"text":" it is not trying to comprehend the name or its placement in a classification.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"When you type your query into the search box you will get ","type":"text"},{"text":"suggestions","type":"text","marks":[{"type":"strong"}]},{"text":" that tell you what your query is likely to return. The system only returns the first 15 matching names in the suggestion, and will end with an ellipsis (…) if there are more results. You can click on one of those suggestions to copy it to the search box.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You don’t have to click on or use the suggestions, just press enter or click the search button with your query.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The name search looks at the 'Full Name including the Author', so the system adds an automatic wild card at the end of the query to match all endings. This means that if you just enter the simple name without author you should find what you want, however it may also return more than you expect.","type":"text"}]},{"type":"paragraph","content":[{"text":"The query is ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" case sensitive.","type":"text"}]},{"type":"paragraph","content":[{"text":"The query is an ordered set of search terms, so viola l. will match \"Viola L.\" and \"Viola L. sect Viola.\"","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"In versions prior to 1.0080 of the NSL services an automatic wild card was added between words (search terms) to match hybrid names and some other name variants. Hybrids are now specifically catered for in searches and the automatic wild card has been removed, making the results of the search more logical to most people.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Putting double quotes around your entire query will cause it to be matched exactly (except case). e.g. \"Viola L.\" will match just Viola L.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You can use wild cards inside quoted queries to get exactly what you want e.g. \"viola betonicifolia subsp. %\"","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You can use a % as a wild card inside the search query e.g. hakea elon% be or \"hakea % var. elon% benth.\" to find \"Hakea ceratophylla var. elongata Benth.\"","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Whilst typing in viola will return most names under the genus Viola l. this is a function of the structure of a scientific name. In fact it will return more names than exist under that genus (91 vs 79).","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You can search for hybrids using the letter 'x' or a multiplication sign &mul; if you use a multiplication sign.","type":"text"}]},{"type":"paragraph","content":[{"text":"Under Construction","type":"text"}]},{"type":"paragraph","content":[{"text":"This documentation is under construction. We understand it needs extending and improving, but we thought we’d let you see what we’ve got so far.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3. Application Interfaces (APIs)","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The information below is technical information for people wanting to connect, search and use information from the NSL via web services. Basically it’s meant for computer programmers, but feel free to have a look if you’re interested.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The NSL services provide a number of Application Interfaces, called APIs, to let you access the name data within.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.1. Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"This section lists recent changes to the API.","type":"text"}]},{"type":"paragraph","content":[{"text":"May 1 2016 : * Removed NSL Simple Name export and JSON representation. June 22 2016 : * Added the Export section * Added name taxon-search api end point","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.2. Linked Data","type":"text"}]},{"type":"paragraph","content":[{"text":"The NSL system uses a linked data service called a mapper or broker to map the URIs for a resource to a service that can provide that resource. As linked data we don’t guarantee that the same service will deliver the resource each time, but we do guarantee the object returned will be the same one associated with that URI.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Mapper takes the URI and will issue you a '303 redirect' to a service that will provide the requested resource in the format requested.","type":"text"}]},{"type":"paragraph","content":[{"text":"The mapper uses content negotiation to provide you with the correct service for the resource in the format you request, e.g. HTML, JSON, XML, RDF. You must follow the 303 redirect to the service and provide the redirected service the same content type to get the correct format.","type":"text"}]},{"type":"paragraph","content":[{"text":"Browsers do not allow you to request a different content type (easily), and you will always get HTML back in a browser. To make it easier to demonstrate the other format, or just browse them we have provided '.format' handling in our services so you can add '.json' or '.xml' to a URL to get the desired format. The .format does not survive the 303 redirection, so you will need to add it to the redirected service URL manually.","type":"text"}]},{"type":"paragraph","content":[{"text":"e.g. the URL ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/70914.json","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/70914.json"}}]},{"text":" redirects to ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://biodiversity.org.au/nsl/services/api/name/apni/70914"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"As you can see below the browser gets the 303 redirect and goes there, but the browser only 'accepts' html.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":686,"id":"a3665a30-e496-4274-8442-0ed88772c85a","collection":"contentId-1380483087","type":"file","height":664}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 2. 303 redirect headers","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If you now add '.json' to the redirected service URL in the browser we can force the response to JSON.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":686,"id":"b9247cc4-b571-4145-aa50-71f776c9ba16","collection":"contentId-1380483087","type":"file","height":664}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 3. Forcing a JSON response using .json","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.3. Basic Resource Objects","type":"text"}]},{"type":"paragraph","content":[{"text":"The basic resource objects in the NSL system are representations of the underlying database objects, which in turn represent the taxonomic world. As such you will need to construct a view of the taxonomic object from these objects. Some higher level api calls perform some of this work for you to create a useful view.","type":"text"}]},{"type":"paragraph","content":[{"text":"The basic form of a URI to return an object from the API via a preferred link is:","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://id.biodiversity.org.au/[objectType]/[namespace]/[random unique number]","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The [random unique number] is not in itself persistent and should ","type":"text"},{"text":"definitely not","type":"text","marks":[{"type":"strong"}]},{"text":" be used as an identifier for a resource. ","type":"text"},{"text":"Always","type":"text","marks":[{"type":"strong"}]},{"text":" use the entire URI, as it is guaranteed to be permanent and will redirect to the correct resource.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.1. Author","type":"text"}]},{"type":"paragraph","content":[{"text":"An Author (person) object represents a Name or Reference author. It’s primary purpose is to act as an identifier for an author that can be linked to another identifier such as an ","type":"text"},{"text":"IPNI Author","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.ipni.org/ipni/authorsearchpage.do"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Currently an author of both references and names may have two Author entries because of the imported APNI data. We will be working to de-duplicate these authors over time.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"An author can have 1000s of names. The HTML repesentation of an Author will summarize the names for you, the JSON will return the brief names for each one. It may take a while to return the JSON object for someone like Brown, R.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"e.g. ","type":"text"},{"text":"https://id.biodiversity.org.au/author/apni/1441","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/author/apni/1441"}}]},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":473,"id":"1ed28d30-03d5-43ce-b391-240d678040d6","collection":"contentId-1380483087","type":"file","height":341}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Figure 4. Author object HTML output","type":"text"}]},{"type":"paragraph","content":[{"text":"Example JSON output (Names left out)","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"class\": \"au.org.biodiversity.nsl.Author\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/1441\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/author/apni/1441\",\n \"resources\": 1\n }\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"LADAMS\",\n \"at\": \"2002-02-13T13:00:00Z\"\n },\n \"updated\": {\n \"by\": \"LADAMS\",\n \"at\": \"2002-02-13T13:00:00Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"abbrev\": \"R.Br.\",\n \"name\": \"Brown, R.\",\n \"fullName\": null,\n \"dateRange\": null,\n \"notes\": null,\n \"ipniId\": null,\n \"duplicateOf\": null,\n \"references\": [],\n \"names\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/82208\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"crassifolius\"\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/128739\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"reflacta\"\n },\n... //(1000s of names)\n ],\n baseNames: [...],\n exNames: [...],\n exBaseNames: [...]\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.2. Instance","type":"text"}]},{"type":"paragraph","content":[{"text":"An instance object represents an instance of the use of a Name in a Reference (a Usage) and it relationship. There are two main Instance occurrences, 'Standalone' instances and 'Relationship' instances (see figure below).","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":677,"id":"6760b1f9-310b-4497-81be-9fea5dadb7c9","collection":"contentId-1380483087","type":"file","height":976}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 5. Instance relationships.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"An Instance is of a particular instance type. Each instance type defines a set of properties for that instance. The currently defined instance types are:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"replaced synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"basionym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pro parte replaced synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nomenclatural synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful nomenclatural synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pro parte nomenclatural synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pro parte misapplied","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful misapplied","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful pro parte misapplied","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"taxonomic synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pro parte taxonomic synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful taxonomic synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful pro parte taxonomic synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pro parte synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful pro parte synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"isonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"autonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"trade name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"comb. et stat. nov.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"comb. nov.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"comb. et nom. nov.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"misapplied","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nom. et stat. nov.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nom. nov.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tax. nov.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"excluded name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"doubtful invalid publication","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"primary reference","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"homonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"invalid publication","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[n/a]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[unknown]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sens. lat.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"common name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"vernacular name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[default]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"secondary reference","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"implicit autonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"orthographic variant","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"As you can see the instance type describes the relationship of the reference to the name.","type":"text"}]},{"type":"paragraph","content":[{"text":"Basic Instance object structure","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {...}, //links to this object and related resources\n \"audit\": {...}, //change information\n \"namespace\": \"APNI\", //The shard or dataset this instance belongs to\n \"verbatimNameString\": \"Doodia R.Br.\", //The name string as written in the reference\n \"page\": \"151\", //The page(s) of the reference this useage was found\n \"pageQualifier\": null, //\n \"nomenclaturalStatus\": null,\n \"bhlUrl\": null, //link to Biodiversity Heritage Librabry http://www.biodiversitylibrary.org/\n \"instanceType\": {},\n \"name\": {},\n \"reference\": {},\n \"parent\": {}, //Parent instance todo: explain\n \"cites\": {}, //An Instance that this instance cites\n \"citedBy\": {}, //An Instance that this instance is cited by\n \"externalRefs\": [],\n \"instancesForCitedBy\": [],\n \"instancesForCites\": [...],\n \"instancesForParent\": [],\n \"instanceNotes\": [...]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"e.g. ","type":"text"},{"text":"https://id.biodiversity.org.au/instance/apni/481759","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/instance/apni/481759"}}]},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":494,"id":"e200a81b-6bb9-47c5-baf2-8e7a7a736828","collection":"contentId-1380483087","type":"file","height":419}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 6. Instance object HTML output","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example Full JSON output","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/481759\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/apni.taxon/81167\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/481759\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/Doodia%20R.Br.\",\n \"resources\": 15\n }\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"ApniDump\",\n \"at\": \"1996-05-22T14:00:00Z\"\n },\n \"updated\": {\n \"by\": \"IBIS\",\n \"at\": \"2012-03-06T13:00:00Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"verbatimNameString\": \"Doodia R.Br.\",\n \"page\": \"151\",\n \"pageQualifier\": null,\n \"nomenclaturalStatus\": null,\n \"bhlUrl\": null,\n \"instanceType\": {\n \"name\": \"tax. nov.\",\n \"flags\": {\n \"primaryInstance\": true,\n \"secondaryInstance\": false,\n \"relationship\": false,\n \"protologue\": true,\n \"taxonomic\": false,\n \"nomenclatural\": false,\n \"synonym\": false,\n \"proParte\": false,\n \"doubtful\": false,\n \"misapplied\": false,\n \"standalone\": true,\n \"unsourced\": false,\n \"citing\": false,\n \"deprecated\": false\n },\n \"sortOrder\": 100,\n \"rdfId\": \"tax-nov\",\n \"descriptionHtml\": \"(description of tax. nov.)\"\n },\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/70914\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"Doodia\"\n },\n \"reference\": {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/22536\",\n \"resources\": 1\n }\n },\n \"citation\": \"Brown, R., (1810) Prodromus Florae Novae Hollandiae\",\n \"citationHtml\": \"Brown, R., (1810) Prodromus Florae Novae Hollandiae\"\n },\n \"parent\": {},\n \"cites\": {},\n \"citedBy\": {},\n \"externalRefs\": [],\n \"instancesForCitedBy\": [],\n \"instancesForCites\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/936501\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"taxonomic synonym\"\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/3749732\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"taxonomic synonym\"\n }\n ],\n \"instancesForParent\": [],\n \"instanceNotes\": [\n {\n \"class\": \"au.org.biodiversity.nsl.InstanceNote\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/1020593\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/instanceNote/apni/1020593\",\n \"resources\": 1\n }\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"APNI_DUMP\",\n \"at\": \"1996-06-11T14:00:00Z\"\n },\n \"updated\": {\n \"by\": \"APNI_DUMP\",\n \"at\": \"1996-06-11T14:00:00Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/481759\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\"\n },\n \"instanceNoteKey\": \"Type\",\n \"value\": \"(not desigated).\"\n }\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.3. InstanceNote","type":"text"}]},{"type":"paragraph","content":[{"text":"Instances can have several notes associated with them. An instance Note consists of a key and a value. Current instance note keys are:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Neotype","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ex.distribution","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"APC Comment","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"EPBC Impact","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Status","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Under","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Distribution","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"URL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lectotype","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Context","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vernacular","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Comment","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Synonym","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"APC Dist.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Etymology","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"EPBC Advice","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"APNI","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type herbarium","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"e.g. ","type":"text"},{"text":"https://id.biodiversity.org.au/instanceNote/apni/1121197","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/instanceNote/apni/1121197"}}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":546,"id":"ab2ef850-eba8-4ac2-8df0-f0a6d2c63617","collection":"contentId-1380483087","type":"file","height":337}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 7. Instance Note object HTML output","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example Full JSON output","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"class\": \"au.org.biodiversity.nsl.InstanceNote\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/1121197\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/instanceNote/apni/1121197\",\n \"resources\": 1\n }\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"KIRSTENC\",\n \"at\": \"2011-10-30T13:00:00Z\"\n },\n \"updated\": {\n \"by\": \"KIRSTENC\",\n \"at\": \"2012-11-16T05:36:05Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/554643\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"secondary reference\"\n },\n \"instanceNoteKey\": \"APC Dist.\",\n \"value\": \"WA\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.4. Name","type":"text"}]},{"type":"paragraph","content":[{"text":"The Name object represents a name string, type, rank, and status. This object is an identifier of a name string with enough information to be able to reconstruct the name string from parts. As an identifier it links together Instances and Authors.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"2c667360-4797-4231-bc29-4aaf0dae216c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"This shouldn’t be confused with the Taxon, which is more correctly described by the Protologue Instance of a Name.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"e.g. ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/70914","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/70914"}}]},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1034,"id":"5158ab49-f0c4-4f70-b512-dca837ec554c","collection":"contentId-1380483087","type":"file","height":966}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 8. Name object HTML output","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example Name object in JSON","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/70914\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/apni.name/16512\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/name/apni/70914\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/Doodia%20R.Br.\",\n \"resources\": 15\n }\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"KIRSTENC\",\n \"at\": \"2009-10-27T03:21:49Z\"\n },\n \"updated\": {\n \"by\": \"KIRSTENC\",\n \"at\": \"2009-10-27T03:21:49Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"fullName\": \"Doodia R.Br.\",\n \"fullNameHtml\": \"Doodia R.Br.\",\n \"nameElement\": \"Doodia\",\n \"simpleName\": \"Doodia\",\n \"rank\": {\n \"name\": \"Genus\",\n \"sortOrder\": 120\n },\n \"type\": \"scientific\",\n \"status\": \"legitimate\",\n \"tags\": [],\n \"parent\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/222592\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"Blechnaceae\"\n },\n \"secondParent\": {},\n \"instances\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/481760\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"secondary reference\"\n },\n... //many instances\n ],\n \"externalRefs\": [],\n \"author\": {\n \"class\": \"au.org.biodiversity.nsl.Author\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/author/apni/1441\",\n \"resources\": 1\n }\n },\n \"name\": \"R.Br.\"\n },\n \"baseAuthor\": {},\n \"exAuthor\": {},\n \"exBaseAuthor\": {},\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/481759\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\"\n }\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.5. NslSimpleName","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"NSL simple has been removed.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.6. Reference","type":"text"}]},{"type":"paragraph","content":[{"text":"A Reference object represents a place that a name might be published. References are categorized by their reference type. The reference types currently defined are:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Book","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chapter","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Database","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Herbarium annotation","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Index","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Journal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Series","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Personal Communication","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Database Record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Paper","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Section","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unknown","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"e.g. ","type":"text"},{"text":"https://id.biodiversity.org.au/reference/apni/22408","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/reference/apni/22408"}}]},{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"A reference can have 1000s of instances of names. The HTML repesentation of a Reference will summarize the instances for you, but the JSON will return the brief instance for each one. It may take a while to return the JSON object.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":598,"id":"e5fabd5e-6289-419b-9d4b-e61c5316906c","collection":"contentId-1380483087","type":"file","height":265}}]},{"type":"paragraph"},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 9. Name object HTML output","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"A reference may have many older URI identifiers due to the duplication in the data imported into NSL. These reference have been largely de-duplicated, but the identifiers remain. We are working through deprecating the older URIs which will cause a 301 redirect to the new permalink.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example Reference object in JSON","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/22408\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/22408\",\n \"resources\": 1\n }\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"ApniDump\",\n \"at\": \"1996-05-22T14:00:00Z\"\n },\n \"updated\": {\n \"by\": \"KIRSTENC\",\n \"at\": \"2000-10-22T13:00:00Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"doi\": null,\n \"title\": \"Dodonaea\",\n \"displayTitle\": \"Dodonaea\",\n \"abbrevTitle\": null,\n \"year\": 1985,\n \"volume\": \"25\",\n \"edition\": null,\n \"pages\": \"114-163\",\n \"verbatimReference\": null,\n \"verbatimCitation\": \"West, J.G., (1985) Dodonaea. Flora of Australia 25.\",\n \"verbatimAuthor\": null,\n \"citation\": \"West, J.G. in George, A.S. (ed.) (1985), Dodonaea. Flora of Australia 25\",\n \"citationHtml\": \"West, J.G. in George, A.S. (ed.) (1985), Dodonaea. Flora of Australia 25\",\n \"notes\": \"within Sapindaceae by Reynolds\",\n \"published\": true,\n \"publisher\": null,\n \"publishedLocation\": null,\n \"publicationDate\": \"1985\",\n \"isbn\": null,\n \"issn\": null,\n \"bhlUrl\": null,\n \"tl2\": null,\n \"refType\": \"Paper\",\n \"parent\": {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/17379\",\n \"resources\": 1\n }\n },\n \"citation\": \"George, A.S. (ed.) (1985), Flora of Australia\",\n \"citationHtml\": \"George, A.S. (ed.) (1985), Flora of Australia\"\n },\n \"author\": {\n \"class\": \"au.org.biodiversity.nsl.Author\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/author/apni/13360\",\n \"resources\": 1\n }\n },\n \"name\": null\n },\n \"refAuthorRole\": \"Unknown\",\n \"duplicateOf\": {},\n \"language\": {\n \"iso6391Code\": null,\n \"iso6393Code\": \"und\",\n \"name\": \"Undetermined\"\n },\n \"externalRefs\": [],\n \"instances\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/554634\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"secondary reference\"\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/484190\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"secondary reference\"\n },\n... //175 more instances\n ],\n \"parentOf\": []\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.7. Node","type":"text"}]},{"type":"paragraph","content":[{"text":"To be completed.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.8. Tree","type":"text"}]},{"type":"paragraph","content":[{"text":"To be completed.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.9. Branch","type":"text"}]},{"type":"paragraph","content":[{"text":"To be completed.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.3.10. Event","type":"text"}]},{"type":"paragraph","content":[{"text":"To be completed.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.4. Name API V1.0","type":"text"}]},{"type":"paragraph","content":[{"text":"The name API lets you query and manipulate names. In general to change a name you need to be authorized to do so.","type":"text"}]},{"type":"paragraph","content":[{"text":"The general format of a name API call is","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[name resource link]/api/[action](.json)(?[params])","type":"text"}]},{"type":"paragraph","content":[{"text":"where the things in round brackets are optional.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a ","type":"text"},{"text":"REST","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Representational_state_transfer"}}]},{"text":" API, and uses HTTP methods to determine the action. If you use the wrong HTTP method you will get an error","type":"text"}]},{"type":"paragraph","content":[{"text":"The services use content negotiation to determine the output type, so a content type of text/JSON gives you JSON response. The services will give an HTML response in a browser, which doesn’t include all the data available in JSON or XML.","type":"text"}]},{"type":"paragraph","content":[{"text":"In this document we will use JSON.","type":"text"}]},{"type":"paragraph","content":[{"text":"The output of services generally include standard JSON object representations of Name, Instance, Reference, [Instance Note], Author","type":"text"}]},{"type":"paragraph","content":[{"text":"If the name record ID doesn’t exist for any operation you will get a 404 status result with the following body (in JSON)","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"action\": \"branch\",\n \"error\": \"The Name was not found.\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"An action that completes will in general return a 200 status, though the action may not have 'worked'. In general an errors field with a list of error strings will be returned with a negative result field it the action doesn’t work.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you can’t do an action (e.g. can’t delete an instance because of references to it) you will generally get a 403 with a payload containing the error message.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you try to do an API call that requires Autorization without supplying a valid API Key, you will get an authorization error response.","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"status\": \"401: Unauthorized\",\n \"uri\": \"/services/name/apni/200112/api/delete.json\",\n \"exception\": \"org.apache.shiro.authz.UnauthenticatedException\",\n \"reason\": \"This subject is anonymous - it does not have any identifying principals and authorization operations require\n an identity to check against. A Subject instance will acquire these identifying principals automatically after a\n successful login is performed be executing org.apache.shiro.subject.Subject.login(AuthenticationToken) or when\n 'Remember Me' functionality is enabled by the SecurityManager. This exception can also occur when a previously\n logged-in Subject has logged out which makes it anonymous again. Because an identity is currently not known due\n to any of these conditions, authorization is denied.\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.1. branch","type":"text"}]},{"type":"paragraph","content":[{"text":"GET branch","type":"text","marks":[{"type":"strong"}]},{"text":" gets the APC branch for this name. This gives you a list of Names in Classification order. e.g.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"using curl","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/61294/api/branch","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/61294/api/branch"}}]},{"text":" ","type":"text"}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"browser","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://id.biodiversity.org.au/name/apni/61294/api/branch.json","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/61294/api/branch.json"}}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a list of Name objects from the top of the classification tree down to the name requested.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/54427\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"Proteaceae\",\n \"action\": \"branch\",\n \"branch\": [\n null,\n {\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/237393\",\n \"resources\": 1\n },\n...\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"ghw\",\n \"at\": \"2012-02-09T06:31:34Z\"\n },\n \"updated\": {\n \"by\": \"AMONRO\",\n \"at\": \"2014-04-04T08:03:27Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"fullName\": \"Eukaryota Whittaker & Margulis\",\n \"fullNameHtml\": \"Eukaryota Whittaker & Margulis\",\n \"nameElement\": \"Eukaryota\",\n \"simpleName\": \"Eukaryota\",\n \"rank\": {\n \"name\": \"Regio\",\n \"sortOrder\": 8\n },\n \"type\": \"scientific\",\n \"status\": \"legitimate\",\n \"tags\": [],\n \"parent\": {},\n \"secondParent\": {},\n \"instances\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/742960\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"secondary reference\"\n }\n ],\n \"externalRefs\": [],\n \"author\": {\n \"class\": \"au.org.biodiversity.nsl.Author\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/author/apni/6349\",\n \"resources\": 1\n }\n },\n \"name\": \"Whittaker & Margulis\"\n },\n \"baseAuthor\": {},\n \"exAuthor\": {},\n \"exBaseAuthor\": {},\n \"primaryInstance\": {}\n }\n },\n {\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n...\n \"fullName\": \"Plantae Haeckel\",\n... }\n },\n {\n...\n },\n {\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n...\n \"fullName\": \"Proteaceae Juss.\",\n...\n }\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.2. delete","type":"text"}]},{"type":"paragraph","content":[{"text":"GET delete","type":"text","marks":[{"type":"strong"}]},{"text":" tells you if a name can be deleted. If not it gives a list of error messages explaining why not.","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE delete","type":"text","marks":[{"type":"strong"}]},{"text":" deletes the name if it can be deleted. If not it gives a list of error messages explaining why not.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You need to be an administrator, or administrator service to call this with the 'DELETE' method. Use your apiKey to authenticate.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Brief Name object","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action: 'delete'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ok: true/false - false means you can’t delete this name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"errors: List - if ok is false this contains a list of error strings explaining the problem","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"if you are trying to delete and it fails (i.e. you didn’t check if you could delete it) you will get a 403 return code, with a payload containing error messages.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"Check if you can delete","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/170107/api/delete","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/170107/api/delete"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/170107\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"pignattiana\"\n },\n \"action\": \"delete\",\n \"ok\": false,\n \"errors\": [\n \"This name is in APC.\",\n \"There are instances that refer to this name\"\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/170107/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/170107/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Non working response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/170107\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"pignattiana\"\n },\n \"action\": \"delete\",\n \"ok\": false,\n \"errors\": [\n \"This name is in APC.\",\n \"There are instances that refer to this name\"\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Working response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/170107\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"pignattiana\"\n },\n \"action\": \"delete\",\n \"ok\": true\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.3. family","type":"text"}]},{"type":"paragraph","content":[{"text":"GET family","type":"text","marks":[{"type":"strong"}]},{"text":" returns the family of the name according to the APNI or 'Name classification'. The Name classification may be different to other classifications such as APC.","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Brief name object of the name you are querying","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action: 'family'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"famlyName: the full Name object of the Family this name belongs to","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/158548/api/family","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/158548/api/family"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n name: {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/158548\",\n \"resources\": 1\n }\n }\n },\n \"nameElement\": \"Taeniatherum\",\n \"action\": \"family\",\n \"familyName\": {\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalinks\": [\n {\n \"link\": \"https://id.biodiversity.org.au/54563\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/apni.name/-239\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/name/apni/54563\",\n \"resources\": 1\n },\n {\n \"link\": \"https://id.biodiversity.org.au/Poaceae%20Barnhart\",\n \"resources\": 22\n }\n ]\n },\n \"audit\": {\n \"created\": {\n \"by\": \"PR1ORITY\",\n \"at\": \"1996-05-23T11:52:17Z\"\n },\n \"updated\": {\n \"by\": \"kcowley\",\n \"at\": \"2015-03-18T04:38:35Z\"\n }\n },\n \"namespace\": \"APNI\",\n \"fullName\": \"Poaceae Barnhart\",\n \"fullNameHtml\": \"Poaceae Barnhart\",\n \"nameElement\": \"Poaceae\",\n \"simpleName\": \"Poaceae\",\n \"rank\": {\n \"name\": \"Familia\",\n \"sortOrder\": 80\n },\n \"type\": \"scientific\",\n \"status\": \"nom. cons.\",\n \"tags\": [],\n \"parent\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/214973\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"Poales\"\n },\n \"secondParent\": {},\n \"instances\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/651988\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"secondary reference\"\n },\n...\n ],\n \"externalRefs\": [],\n \"author\": {\n \"class\": \"au.org.biodiversity.nsl.Author\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/author/apni/8141\",\n \"resources\": 1\n }\n },\n \"name\": \"Barnhart\"\n },\n \"baseAuthor\": {},\n \"exAuthor\": {},\n \"exBaseAuthor\": {},\n \"primaryInstance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/631978\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\"\n }\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.4. apc","type":"text"}]},{"type":"paragraph","content":[{"text":"GET apc","type":"text","marks":[{"type":"strong"}]},{"text":" tells you if this name is in the APC classification tree.","type":"text"}]},{"type":"paragraph","content":[{"text":"A name being in the classification tree is not the same as the name being part of the Australian Plant Census. Names in the APC tree have one of the following types:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ApcConcept","type":"text","marks":[{"type":"strong"}]},{"text":". The name is part of APC.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ApcExcluded","type":"text","marks":[{"type":"strong"}]},{"text":". An excluded name. For convenience, a boolean attribute 'excluded' is also included in the response.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DeclaredBt","type":"text","marks":[{"type":"strong"}]},{"text":". Names that, in the previous system, were declared as being \"Broader Terms\" of names in APC, but which were not themselves in APC.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"A typical place where 'DeclaredBt' nodes appear in the tree is when several species under a genus are excluded, but where the genus itself has not been dealt with explicitly. Another place where they can appear is where a higher taxonomy is not completed for a group of names.","type":"text"}]},{"type":"paragraph","content":[{"text":"That is, you cannot treat 'DeclaredBt' as implying that the name is (or should be) an excluded name, or that it is (or should be) part of APC. Even in the case where a number of species in a genus have been excluded, but where the genus is a 'DeclaredBt', it may or may not be the case that the genus has another species that does appear in Australia.","type":"text"}]},{"type":"paragraph","content":[{"text":"Work on the Australian Plant Census is ongoing. As users of the data, all that we know about DeclaredBt names is that the name was used as a higher grouping in the previous APC system with nothing more being said about it by the APC team. We imported this data into the NSL as it was.","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Brief name of the name in the query","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"inAPC: true/false","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/54427/api/apc","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/54427/api/apc"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/54427\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"Proteaceae\"\n },\n \"action\": \"apc\",\n \"inAPC\": true,\n \"excluded\": false,\n \"nsl-name\": 54427,\n \"nameNs\": \"nsl-name\",\n \"nameId\": \"54427\",\n \"taxonNs\": \"nsl-instance\",\n \"taxonId\": \"650643\",\n \"type\": \"ApcConcept\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.5. apni","type":"text"}]},{"type":"paragraph","content":[{"text":"GET apni","type":"text","marks":[{"type":"strong"}]},{"text":" Tells you if this name is in the APNI classification.","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Brief name of the name in the query","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"inAPNI: true/false","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://id.biodiversity.org.au/name/apni/54427/api/apni"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/54427\",\n \"resources\": 1\n }\n }\n },\n \"nameElement\": \"Proteaceae\",\n \"action\": \"apni\",\n \"inAPNI\": true,\n \"nsl-name\": 54427,\n \"nameNs\": \"nsl-name\",\n \"nameId\": \"54427\",\n \"taxonNs\": null,\n \"taxonId\": null\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.6. name-strings","type":"text"}]},{"type":"paragraph","content":[{"text":"GET name-strings","type":"text","marks":[{"type":"strong"}]},{"text":" constructs the name strings for this Name using the rules in the 'ConstructedNameService' and returns them as a JSON resource. This will not change the Name object.","type":"text"}]},{"type":"paragraph","content":[{"text":"PUT name-strings","type":"text","marks":[{"type":"strong"}]},{"text":" constructs the name strings for this Name using the rules in the 'ConstructedNameService', updates the Name object with these strings, and returns them as a JSON resource.","type":"text"}]},{"type":"paragraph","content":[{"text":"Updating the name strings of a Name may be necessary if a name string gets out of sync with the Name data for some reason, (such as an SQL update) or the name construction algorithm has been changed.","type":"text"}]},{"type":"paragraph","content":[{"text":"This will re-write the full and simple names on the name object and cause the name updater to run updating NSL Simple Names and contacting anyone who has registered to get notifications of changes.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You need to be an administrator, or administrator service to call this with PUT. Use your apiKey to authenticate.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Brief na of the name in the query","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action: 'nameStrings'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"result:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"fullMarkedUpName: the full name including author marked up with HTML5/XML","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"simpleMarkedUpName: the name sans author marked up with HTML5/XML","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"fullName: the full name with author in plain text","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"simpleName: the name sans author in plain text","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/185029/api/name-strings","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/185029/api/name-strings"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/185029\",\n \"resources\": 1\n }\n }\n },\n \"nameElement\": \"sp. Stony Creek (P.I.Forster 37B)\",\n \"action\": \"nameStrings\",\n \"result\": {\n \"fullMarkedUpName\": \"Backhousia sp. Stony Creek (P.I.Forster 37B)\",\n \"simpleMarkedUpName\": \"Backhousia sp. Stony Creek (P.I.Forster 37B)\",\n \"fullName\": \"Backhousia sp. Stony Creek (P.I.Forster 37B)\",\n \"simpleName\": \"Backhousia sp. Stony Creek (P.I.Forster 37B)\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/name/apni/172107/api/name-strings?apiKey=aaaaa-bbbbbb-eeee-ccccc-sssss","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/172107/api/name-strings?apiKey=aaaaa-bbbbbb-eeee-ccccc-sssss"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/172107\",\n \"resources\": 1\n }\n },\n \"nameElement\": \"Burrendong Beauty\"\n },\n \"action\": \"nameStrings\",\n \"result\": {\n \"fullMarkedUpName\": \"Hakea ‘Burrendong Beauty’\",\n \"simpleMarkedUpName\": \"Hakea ‘Burrendong Beauty’\",\n \"fullName\": \"Hakea 'Burrendong Beauty'\",\n \"simpleName\": \"Hakea 'Burrendong Beauty'\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.7. name-update-event-uri","type":"text"}]},{"type":"paragraph","content":[{"text":"PUT name-update-event-uri","type":"text","marks":[{"type":"strong"}]},{"text":" to have your service notified of changes to a name register a call back URI with the NSL services using registerNameUpdateEventUri.","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE name-update-event-uri","type":"text","marks":[{"type":"strong"}]},{"text":" removes your uri from our event notification list, your service will stop being notified of name updates.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"uri: the URI you wish to put or remove","type":"text"}]},{"type":"paragraph","content":[{"text":"This will register your URI with the name service. when a Name change occurs this URI will be called with the type of update and the Identifier.","type":"text"}]},{"type":"codeBlock","content":[{"text":"http://[your uri]/[type]?id=[name identifier uri]","type":"text"}]},{"type":"paragraph","content":[{"text":"The type will be one of:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"delete","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For example it may call:","type":"text"}]},{"type":"paragraph","content":[{"text":"http://myservice.org.au/notify/update?id=https://id.biodiversity.org.au/name/apni/70914","type":"text","marks":[{"type":"link","attrs":{"href":"http://myservice.org.au/notify/update?id=https://id.biodiversity.org.au/name/apni/70914"}}]}]},{"type":"paragraph","content":[{"text":"Your service end point can then just call that URI identifier directly to get the updated name details (see Name).","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1 add a URI","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X PUT ","type":"text"},{"text":"https://biodiversity.org.au/nsl/services/api/name/name-update-event-uri?uri=http://localhost:8088/test","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/api/name/name-update-event-uri?uri=http://localhost:8088/test"}}]}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\"text\":\"registered http://localhost:8088/test\"}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2 delete a URI","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://biodiversity.org.au/nsl/services/api/name/name-update-event-uri?uri=http://localhost:8088/test","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/api/name/name-update-event-uri?uri=http://localhost:8088/test"}}]}]}]},{"type":"paragraph","content":[{"text":"Example response","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"text\":\"unregistered ","type":"text"},{"text":"http://localhost:8088/test\"}","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8088/test"}}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.8. export-nsl-simple","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This export has been removed and replaced with taxon and name exports. see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://biodiversity.org.au/nsl/services/api/export/index/"}},{"text":" ","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.9. apni-format / apni-format-embed","type":"text"}]},{"type":"paragraph","content":[{"text":"GET apni-format","type":"text","marks":[{"type":"strong"}]},{"text":" gets the APNI formatted output for a Name.","type":"text"}]},{"type":"paragraph","content":[{"text":"GET apni-format-embed","type":"text","marks":[{"type":"strong"}]},{"text":" gets the APNI formatted output for a Name in an embeddable format.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"541e6802-be8c-4ab5-8589-d3e145697016"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"this is currently only available as HTML","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"https://id.biodiversity.org.au/name/apni/61294/api/apni-format","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/61294/api/apni-format"}}]},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1084,"id":"39bb7c75-c019-4208-b0c6-b588d4fb3579","collection":"contentId-1380483087","type":"file","height":875}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 10. APNI Format HTML output","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"https://id.biodiversity.org.au/name/apni/61294/api/apni-format-embed","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/61294/api/apni-format-embed"}}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1084,"id":"358c1edd-fed5-4b53-a6b7-c8ba7eec049b","collection":"contentId-1380483087","type":"file","height":875}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 11. APNI Format HTML embeded output","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.10. apc-format / apc-format-embed","type":"text"}]},{"type":"paragraph","content":[{"text":"GET apni-format","type":"text","marks":[{"type":"strong"}]},{"text":" gets the APC formatted output for a Name.","type":"text"}]},{"type":"paragraph","content":[{"text":"GET apni-format-embed","type":"text","marks":[{"type":"strong"}]},{"text":" gets the APC formatted output for a Name in an embedable format.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"this is currently only available as HTML","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"embed: if set to true get the output as an embedable fragment of html.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"https://id.biodiversity.org.au/name/apni/61294/api/apc-format","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/61294/api/apc-format"}}]},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1084,"id":"666e55bb-9654-480d-a21d-3b44cbaf0b0a","collection":"contentId-1380483087","type":"file","height":875}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 12. APC Format HTML output","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"https://id.biodiversity.org.au/name/apni/61294/api/apc-format-embed","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/name/apni/61294/api/apc-format-embed"}}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1084,"id":"e366d649-f3a9-498d-b957-8bb0271f0d08","collection":"contentId-1380483087","type":"file","height":875}}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Figure 13. APC Format HTML embeded output","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.11. simple-name","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"32f09f84-3f2a-4750-8321-47d9af4823f3"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"this has been removed.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.12. acceptable-name","type":"text"}]},{"type":"paragraph","content":[{"text":"GET acceptable-name","type":"text","marks":[{"type":"strong"}]},{"text":" gets a list of acceptable brief format names given the simple or full name.","type":"text"}]},{"type":"paragraph","content":[{"text":"An 'acceptable' name is one that is not illegitimate or illegal and has one of the following name status'","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'legitimate'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'manuscript'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'nom. alt.'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'nom. cons.'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'nom. cons., nom. alt.'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'nom. cons., orth. cons.'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'nom. et typ. cons.'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'orth. cons.'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"'typ. cons.'","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"name: the search term","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You should quote the search term for an exact match otherwise the term is tokenized and wild carded. (e.g. poa fa becomes poa fa* where * is a wild card). You can use the same search modifiers as documented in Name Search.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://biodiversity.org.au/nsl/services/api/name/acceptable-name.json?name=%22poa%20fax%22","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/api/name/acceptable-name.json?name=%22poa%20fax%22"}}]}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"action\": \"acceptable-name\",\n \"count\": 1,\n \"names\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/89770\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/511085\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"nom. nov.\",\n \"protologue\": true,\n \"citation\": \"Willis, J.H. & Court, A.B. (1956), Changes in the nomenclature of three Victorian Monocotyledons. Muelleria 1(1)\",\n \"citationHtml\": \"Willis, J.H. & Court, A.B. (1956), Changes in the nomenclature of three Victorian Monocotyledons. Muelleria 1(1)\"\n }\n ],\n \"fullName\": \"Poa fax J.H.Willis & Court\",\n \"fullNameHtml\": \"Poa fax J.H.Willis & Court\",\n \"simpleName\": \"Poa fax\",\n \"simpleNameHtml\": \"Poa fax\"\n }\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.13. apni-concepts","type":"text"}]},{"type":"paragraph","content":[{"text":"GET apni-concepts","type":"text","marks":[{"type":"strong"}]},{"text":" gets a JSON representation of the APNI Format information on a name. This gives a summary of the name information and the usage instances of the name in references with their relationships.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"relationships=false - gives you a shorter output without synonomy (see example 2), this takes less time to return.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The output us broken into two main sections, name and references. Name includes the name, its primary instance (normally the protologue), if it’s in APC and its Family.","type":"text"}]},{"type":"paragraph","content":[{"text":"The references section contains an ","type":"text"},{"text":"ordered","type":"text","marks":[{"type":"strong"}]},{"text":" list of references that contain a list of 'citations', or relationship name usage instances. References without citations are stand alone references.","type":"text"}]},{"type":"paragraph","content":[{"text":"The citation instance link under a Reference should be used in preference to the Reference, since it contains the usage information linking the reference to a name with a relationship, including the page, e.g.:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/482014\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"365, adnot.\",\n \"relationship\": \"tax. nov.\"\n }\n ],","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"https://biodiversity.org.au/nsl/services/name/apni/71063/api/apni-concepts.json","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/name/apni/71063/api/apni-concepts.json"}}]}]},{"type":"paragraph","content":[{"text":"Result","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/71063\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/482014\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\",\n \"protologue\": true,\n \"citation\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\",\n \"citationHtml\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\"\n }\n ],\n \"fullName\": \"Doodia blechnoides A.Cunn.\",\n \"fullNameHtml\": \"Doodia blechnoides A.Cunn.\",\n \"simpleName\": \"Doodia blechnoides\",\n \"simpleNameHtml\": \"Doodia blechnoides\",\n \"inAPC\": false,\n \"family\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/222592\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Familia\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/649463\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\",\n \"protologue\": true,\n \"citation\": \"Newman, E. (1844), A History of British Ferns and Allied Plants Edn. 2\",\n \"citationHtml\": \"Newman, E. (1844), A History of British Ferns and Allied Plants Edn. 2\"\n }\n ],\n \"fullName\": \"Blechnaceae Newman\",\n \"fullNameHtml\": \"Blechnaceae Newman\",\n \"simpleName\": \"Blechnaceae\",\n \"simpleNameHtml\": \"Blechnaceae\"\n }\n },\n \"action\": \"apni-concepts\",\n \"references\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/27758\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\",\n \"citationHtml\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/482014\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"365, adnot.\",\n \"relationship\": \"tax. nov.\"\n }\n ],\n \"notes\": [\n {\n \"instanceNoteKey\": \"Type\",\n \"instanceNoteText\": \"\\\"New South Wales. In dark ravines on the Warrabunha River. 1825, C. Fraser. A. Cunningham.\\\"\"\n }\n ]\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/51580\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Smith, J. in Hooker, W.J. (ed.) (1846), An Enumeration of ferns cultivated in the Royal Gardens at Kew, in December 1845; with characters and observations on some of the genera and species. Botanical Magazine 72 (Comp.)\",\n \"citationHtml\": \"Smith, J. in Hooker, W.J. (ed.) (1846), An Enumeration of ferns cultivated in the Royal Gardens at Kew, in December 1845; with characters and observations on some of the genera and species. Botanical Magazine 72 (Comp.)\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/709662\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"27\",\n \"relationship\": \"secondary reference\"\n },\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/936523\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"27\",\n \"relationship\": \"taxonomic synonym: Doodia maxima J.Sm.\",\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/71252\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"nom. inval., pro syn.\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/482320\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"primary reference\",\n \"protologue\": false,\n \"citation\": \"Smith, J. in Hooker, W.J. (ed.) (1846), An Enumeration of ferns cultivated in the Royal Gardens at Kew, in December 1845; with characters and observations on some of the genera and species. Botanical Magazine 72 (Comp.)\",\n \"citationHtml\": \"Smith, J. in Hooker, W.J. (ed.) (1846), An Enumeration of ferns cultivated in the Royal Gardens at Kew, in December 1845; with characters and observations on some of the genera and species. Botanical Magazine 72 (Comp.)\"\n }\n ],\n \"fullName\": \"Doodia maxima J.Sm.\",\n \"fullNameHtml\": \"Doodia maxima J.Sm.\",\n \"simpleName\": \"Doodia maxima\",\n \"simpleNameHtml\": \"Doodia maxima\"\n }\n }\n ],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/23163\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Mettenius, G.H. (1856), Filices Horti Botanici Lipsiensis\",\n \"citationHtml\": \"Mettenius, G.H. (1856), Filices Horti Botanici Lipsiensis\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/536834\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"65\",\n \"relationship\": \"basionym of Woodwardia blechnoides (A.Cunn.) Mett.\",\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/106724\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/536834\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"comb. nov.\",\n \"protologue\": true,\n \"citation\": \"Mettenius, G.H. (1856), Filices Horti Botanici Lipsiensis\",\n \"citationHtml\": \"Mettenius, G.H. (1856), Filices Horti Botanici Lipsiensis\"\n }\n ],\n \"fullName\": \"Woodwardia blechnoides (A.Cunn.) Mett.\",\n \"fullNameHtml\": \"Woodwardia blechnoides (A.Cunn.) Mett.\",\n \"simpleName\": \"Woodwardia blechnoides\",\n \"simpleNameHtml\": \"Woodwardia blechnoides\"\n }\n }\n ],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/35974\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Christensen, C.F.A. (1905), Index Filicum\",\n \"citationHtml\": \"Christensen, C.F.A. (1905), Index Filicum\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/630850\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"243\",\n \"relationship\": \"replaced synonym of Doodia maxima J.Sm. ex C.Chr.\",\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/177958\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/630850\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"nom. nov.\",\n \"protologue\": true,\n \"citation\": \"Christensen, C.F.A. (1905), Index Filicum\",\n \"citationHtml\": \"Christensen, C.F.A. (1905), Index Filicum\"\n }\n ],\n \"fullName\": \"Doodia maxima J.Sm. ex C.Chr.\",\n \"fullNameHtml\": \"Doodia maxima J.Sm. ex C.Chr.\",\n \"simpleName\": \"Doodia maxima\",\n \"simpleNameHtml\": \"Doodia maxima\"\n }\n }\n ],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/40155\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Parris, B.S. in McCarthy, P.M. (ed.) (1998), Doodia. Flora of Australia 48\",\n \"citationHtml\": \"Parris, B.S. in McCarthy, P.M. (ed.) (1998), Doodia. Flora of Australia 48\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/578616\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"387, Figs 80, 130A-C, Map 350\",\n \"relationship\": \"taxonomic synonym of Doodia maxima J.Sm. ex C.Chr.\",\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/177958\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/630850\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"nom. nov.\",\n \"protologue\": true,\n \"citation\": \"Christensen, C.F.A. (1905), Index Filicum\",\n \"citationHtml\": \"Christensen, C.F.A. (1905), Index Filicum\"\n }\n ],\n \"fullName\": \"Doodia maxima J.Sm. ex C.Chr.\",\n \"fullNameHtml\": \"Doodia maxima J.Sm. ex C.Chr.\",\n \"simpleName\": \"Doodia maxima\",\n \"simpleNameHtml\": \"Doodia maxima\"\n }\n }\n ],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/53841\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"CHAH (2014), Australian Plant Census\",\n \"citationHtml\": \"CHAH (2014), Australian Plant Census\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/781116\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": null,\n \"relationship\": \"taxonomic synonym of Doodia maxima J.Sm. ex C.Chr.\",\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/177958\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/630850\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"nom. nov.\",\n \"protologue\": true,\n \"citation\": \"Christensen, C.F.A. (1905), Index Filicum\",\n \"citationHtml\": \"Christensen, C.F.A. (1905), Index Filicum\"\n }\n ],\n \"fullName\": \"Doodia maxima J.Sm. ex C.Chr.\",\n \"fullNameHtml\": \"Doodia maxima J.Sm. ex C.Chr.\",\n \"simpleName\": \"Doodia maxima\",\n \"simpleNameHtml\": \"Doodia maxima\"\n }\n }\n ],\n \"notes\": []\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2 sans relationships","type":"text"}]},{"type":"paragraph","content":[{"text":"https://biodiversity.org.au/nsl/services/name/apni/71063/api/apni-concepts.json?relationships=false","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/name/apni/71063/api/apni-concepts.json?relationships=false"}}]}]},{"type":"paragraph","content":[{"text":"Result","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/71063\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Species\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/482014\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\",\n \"protologue\": true,\n \"citation\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\",\n \"citationHtml\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\"\n }\n ],\n \"fullName\": \"Doodia blechnoides A.Cunn.\",\n \"fullNameHtml\": \"Doodia blechnoides A.Cunn.\",\n \"simpleName\": \"Doodia blechnoides\",\n \"simpleNameHtml\": \"Doodia blechnoides\",\n \"inAPC\": false,\n \"family\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/222592\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameType\": \"scientific\",\n \"nameStatus\": \"legitimate\",\n \"nameRank\": \"Familia\",\n \"primaryInstance\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/649463\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\",\n \"protologue\": true,\n \"citation\": \"Newman, E. (1844), A History of British Ferns and Allied Plants Edn. 2\",\n \"citationHtml\": \"Newman, E. (1844), A History of British Ferns and Allied Plants Edn. 2\"\n }\n ],\n \"fullName\": \"Blechnaceae Newman\",\n \"fullNameHtml\": \"Blechnaceae Newman\",\n \"simpleName\": \"Blechnaceae\",\n \"simpleNameHtml\": \"Blechnaceae\"\n }\n },\n \"action\": \"apni-concepts\",\n \"references\": [\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/27758\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\",\n \"citationHtml\": \"Cunningham, A. in Hooker, W.J. (1837), Companion to the Botanical Magazine 2(24)\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/482014\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"365, adnot.\",\n \"relationship\": \"tax. nov.\"\n }\n ],\n \"notes\": [\n {\n \"instanceNoteKey\": \"Type\",\n \"instanceNoteText\": \"\\\"New South Wales. In dark ravines on the Warrabunha River. 1825, C. Fraser. A. Cunningham.\\\"\"\n }\n ]\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/51580\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Smith, J. in Hooker, W.J. (ed.) (1846), An Enumeration of ferns cultivated in the Royal Gardens at Kew, in December 1845; with characters and observations on some of the genera and species. Botanical Magazine 72 (Comp.)\",\n \"citationHtml\": \"Smith, J. in Hooker, W.J. (ed.) (1846), An Enumeration of ferns cultivated in the Royal Gardens at Kew, in December 1845; with characters and observations on some of the genera and species. Botanical Magazine 72 (Comp.)\",\n \"citations\": [\n {\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/709662\",\n \"preferred\": true,\n \"resources\": 1\n }\n }\n },\n \"page\": \"27\",\n \"relationship\": \"secondary reference\"\n }\n ],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/23163\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Mettenius, G.H. (1856), Filices Horti Botanici Lipsiensis\",\n \"citationHtml\": \"Mettenius, G.H. (1856), Filices Horti Botanici Lipsiensis\",\n \"citations\": [],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/35974\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Christensen, C.F.A. (1905), Index Filicum\",\n \"citationHtml\": \"Christensen, C.F.A. (1905), Index Filicum\",\n \"citations\": [],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/40155\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Parris, B.S. in McCarthy, P.M. (ed.) (1998), Doodia. Flora of Australia 48\",\n \"citationHtml\": \"Parris, B.S. in McCarthy, P.M. (ed.) (1998), Doodia. Flora of Australia 48\",\n \"citations\": [],\n \"notes\": []\n },\n {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/53841\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"CHAH (2014), Australian Plant Census\",\n \"citationHtml\": \"CHAH (2014), Australian Plant Census\",\n \"citations\": [],\n \"notes\": []\n }\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.14. find-concept","type":"text"}]},{"type":"paragraph","content":[{"text":"GET find-concept","type":"text","marks":[{"type":"strong"}]},{"text":" finds the concept (Instance) with a reference that most matches the given term. You get back the brief name plus the instance that most matched the term given. The rank field tells you how many of the tokens in the term matched the reference citation. The brief Instance tells you the reference found.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"https://biodiversity.org.au/nsl/services/name/apni/166271/api/find-concept.json?term=B.S","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/name/apni/166271/api/find-concept.json?term=B.S"}}]},{"text":". Parris (1998)","type":"text"}]},{"type":"paragraph","content":[{"text":"Result","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Name\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/name/apni/166271\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"nameElement\": \"australis\"\n },\n \"action\": \"find-concept\",\n \"matchedOn\": \"B.S. Parris (1998)\",\n \"rank\": 3,\n \"instance\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/578620\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"instanceType\": \"comb. nov.\",\n \"protologue\": true,\n \"citation\": \"Parris, B.S. in McCarthy, P.M. (ed.) (1998), Doodia. Flora of Australia 48\",\n \"citationHtml\": \"Parris, B.S. in McCarthy, P.M. (ed.) (1998), Doodia. Flora of Australia 48\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.4.15. taxon-search","type":"text"}]},{"type":"paragraph","content":[{"text":"GET taxon-search","type":"text","marks":[{"type":"strong"}]},{"text":" finds the taxon in a classification, returning the output in the Taxon Export format.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"q=Some name - e.g. Isopogon asper","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tree=APC - The classification to use for the output. Currently only APC available.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"using curl curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://biodiversity.org.au/nsl/services/api/name/taxon-search?q=Isopogon%20asper&tree=APC"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"using browser (HTML result) ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://biodiversity.org.au/nsl/services/api/name/taxon-search?q=Isopogon%20asper&tree=APC"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"using browser (JSON result) ","type":"text"},{"text":"https://biodiversity.org.au/nsl/services/api/name/taxon-search.json?q=Isopogon%20asper&tree=APC","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/api/name/taxon-search.json?q=Isopogon%20asper&tree=APC"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Result","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"records\": {\n \"acceptedNames\": {\n \"http://id.biodiversity.org.au/name/apni/83644\": {\n \"nomenclaturalCode\": \"ICNAFP\",\n \"taxonID\": \"http://id.biodiversity.org.au/node/apni/2910941\",\n \"nameType\": \"scientific\",\n \"scientificNameID\": \"http://id.biodiversity.org.au/name/apni/83644\",\n \"scientificName\": \"Isopogon asper R.Br.\",\n \"nomenclaturalStatus\": null,\n \"taxonomicStatus\": \"ApcConcept\",\n \"proParte\": \"false\",\n \"acceptedNameUsage\": null,\n \"acceptedNameUsageID\": \"http://id.biodiversity.org.au/node/apni/2910941\",\n \"parentNameUsageID\": \"http://id.biodiversity.org.au/node/apni/2899417\",\n \"taxonRank\": \"Species\",\n \"taxonRankSortOrder\": \"190\",\n \"kingdom\": \"Plantae\",\n \"class\": \"Equisetopsida\",\n \"subclass\": \"Magnoliidae\",\n \"family\": \"Proteaceae\",\n \"created\": \"2005-11-08 14:57:02.0\",\n \"modified\": \"2005-11-08 14:57:02.0\",\n \"datasetName\": \"{APC,APNI}\",\n \"taxonConceptID\": \"http://id.biodiversity.org.au/instance/apni/558152\",\n \"nameAccordingToID\": \"http://id.biodiversity.org.au/reference/apni/39973\",\n \"nameAccordingTo\": \"Foreman, D.B. in McCarthy, P.M. (ed.) (1995), Isopogon. Flora of Australia 16\",\n \"taxonRemarks\": null,\n \"taxonDistribution\": \"WA\",\n \"higherClassification\": \"Plantae.Charophyta.Equisetopsida.Magnoliidae.Proteanae.Proteales.Proteaceae.Isopogon.asper\",\n \"ccLicense\": \"http://creativecommons.org/licenses/by/3.0/\",\n \"ccAttributionIRI \": \"http://id.biodiversity.org.au/node/apni/2910941\",\n \"canonicalName\": \"Isopogon asper\",\n \"scientificNameAuthorship\": \"R.Br.\",\n \"firstHybridParentName\": null,\n \"firstHybridParentNameID\": null,\n \"secondHybridParentName\": null,\n \"secondHybridParentNameID\": null,\n \"synonyms\": [\n {\n \"nomenclaturalCode\": \"ICNAFP\",\n \"taxonID\": \"http://id.biodiversity.org.au/instance/apni/836387\",\n \"nameType\": \"scientific\",\n \"scientificNameID\": \"http://id.biodiversity.org.au/name/apni/101223\",\n \"scientificName\": \"Isopogon scaber Lindl.\",\n \"nomenclaturalStatus\": null,\n \"taxonomicStatus\": \"taxonomic synonym\",\n \"proParte\": \"false\",\n \"acceptedNameUsage\": \"Isopogon asper R.Br.\",\n \"acceptedNameUsageID\": \"http://id.biodiversity.org.au/node/apni/2910941\",\n \"parentNameUsageID\": null,\n \"taxonRank\": \"Species\",\n \"taxonRankSortOrder\": \"190\",\n \"kingdom\": \"Plantae\",\n \"class\": \"Equisetopsida\",\n \"subclass\": \"Magnoliidae\",\n \"family\": \"Proteaceae\",\n \"created\": \"2005-11-14 13:02:48.0\",\n \"modified\": \"2005-11-14 13:02:48.0\",\n \"datasetName\": \"{APNI}\",\n \"taxonConceptID\": \"http://id.biodiversity.org.au/instance/apni/528706\",\n \"nameAccordingToID\": \"http://id.biodiversity.org.au/reference/apni/43047\",\n \"nameAccordingTo\": \"Lindley, J. (1840), A Sketch of the Vegetation of the Swan River Colony\",\n \"taxonRemarks\": null,\n \"taxonDistribution\": \"WA\",\n \"higherClassification\": null,\n \"ccLicense\": \"http://creativecommons.org/licenses/by/3.0/\",\n \"ccAttributionIRI \": \"http://id.biodiversity.org.au/instance/apni/836387\",\n \"canonicalName\": \"Isopogon scaber\",\n \"scientificNameAuthorship\": \"Lindl.\",\n \"firstHybridParentName\": null,\n \"firstHybridParentNameID\": null,\n \"secondHybridParentName\": null,\n \"secondHybridParentNameID\": null\n },\n {\n \"nomenclaturalCode\": \"ICNAFP\",\n \"taxonID\": \"http://id.biodiversity.org.au/instance/apni/816198\",\n \"nameType\": \"scientific\",\n \"scientificNameID\": \"http://id.biodiversity.org.au/name/apni/113461\",\n \"scientificName\": \"Atylus asper (R.Br.) Kuntze\",\n \"nomenclaturalStatus\": null,\n \"taxonomicStatus\": \"nomenclatural synonym\",\n \"proParte\": \"false\",\n \"acceptedNameUsage\": \"Isopogon asper R.Br.\",\n \"acceptedNameUsageID\": \"http://id.biodiversity.org.au/node/apni/2910941\",\n \"parentNameUsageID\": null,\n \"taxonRank\": \"Species\",\n \"taxonRankSortOrder\": \"190\",\n \"kingdom\": \"Plantae\",\n \"class\": \"Equisetopsida\",\n \"subclass\": \"Magnoliidae\",\n \"family\": \"Proteaceae\",\n \"created\": \"2004-08-26 12:27:54.0\",\n \"modified\": \"2004-08-26 12:27:54.0\",\n \"datasetName\": \"{APNI}\",\n \"taxonConceptID\": \"http://id.biodiversity.org.au/instance/apni/547092\",\n \"nameAccordingToID\": \"http://id.biodiversity.org.au/reference/apni/23167\",\n \"nameAccordingTo\": \"Kuntze, C.E.O. (1891), Revisio Generum Plantarum 2\",\n \"taxonRemarks\": null,\n \"taxonDistribution\": \"WA\",\n \"higherClassification\": null,\n \"ccLicense\": \"http://creativecommons.org/licenses/by/3.0/\",\n \"ccAttributionIRI \": \"http://id.biodiversity.org.au/instance/apni/816198\",\n \"canonicalName\": \"Atylus asper\",\n \"scientificNameAuthorship\": \"(R.Br.) Kuntze\",\n \"firstHybridParentName\": null,\n \"firstHybridParentNameID\": null,\n \"secondHybridParentName\": null,\n \"secondHybridParentNameID\": null\n }\n ]\n }\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.5. Instance API V1.0","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.5.1. delete","type":"text"}]},{"type":"paragraph","content":[{"text":"GET delete","type":"text","marks":[{"type":"strong"}]},{"text":" tells you if a Instance can be deleted. If not it gives a list of error messages explaining why not.","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE delete","type":"text","marks":[{"type":"strong"}]},{"text":" deletes the Instance if it can be deleted. If not it gives a list of error messages explaining why not.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You need to be an administrator, or administrator service to call this with the 'DELETE' method. Use your apiKey to authenticate.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Brief Instance object","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action: 'delete'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ok: true/false - false means you can’t delete this instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"errors: List - if ok is false this contains a list of error strings explaining the problem","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"if you are trying to delete and it fails (i.e. you didn’t check if you could delete it) you will get a 403 return code, with a payload containing error messages.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example: Check if you can delete","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/instance/apni/481811/api/delete","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/instance/apni/481811/api/delete"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/481811\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\"\n },\n \"action\": \"delete\",\n \"ok\": false,\n \"errors\": [\n \"There are 4 instances that cite this.\",\n \"There are 1 instances notes on this.\"\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Failing example trying to delete","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://id.biodiversity.org.au/instance/apni/481811/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/instance/apni/481811/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Non working response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/instance/apni/481811\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"tax. nov.\"\n },\n \"action\": \"delete\",\n \"ok\": false,\n \"errors\": [\n \"There are 4 instances that cite this.\",\n \"There are 1 instances notes on this.\"\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Working example trying to delete","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://id.biodiversity.org.au/instance/apni/453850/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/instance/apni/453850/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Working response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": {\n \"class\": \"au.org.biodiversity.nsl.Instance\",\n \"_links\": {\n \"permalink\": {\n \"link\": https://id.biodiversity.org.au/instance/apni/453850\",\n \"resources\": 1\n }\n },\n \"instanceType\": \"secondary reference\"\n },\n \"action\": \"delete\",\n \"ok\": true\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.6. Reference API V1.0","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.6.1. citation-strings","type":"text"}]},{"type":"paragraph","content":[{"text":"GET citation-strings","type":"text","marks":[{"type":"strong"}]},{"text":" constructs the citation strings for this Reference using the rules in the 'ReferenceService' and returns them as a JSON resource. This will not change the Reference object.","type":"text"}]},{"type":"paragraph","content":[{"text":"PUT citation-strings","type":"text","marks":[{"type":"strong"}]},{"text":" constructs the citation strings for this Reference using the rules in the 'ReferenceService', updates the Reference object with these strings, and returns them as a JSON resource.","type":"text"}]},{"type":"paragraph","content":[{"text":"Updating the citation strings of a Reference may be necessary if a citation string gets out of sync with the Reference data for some reason, (such as an SQL update) or the citation construction algorithm has been changed.","type":"text"}]},{"type":"paragraph","content":[{"text":"This will re-write the HTML and plain citation on the Reference object.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You need to be an administrator, or administrator service to call this with PUT. Use your apiKey to authenticate.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Brief Reference of the reference in the query","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action: 'citation-strings'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"result:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"citationHtml: the full citation marked up with HTML5/XML","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"citation: the citation in plain text","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/reference/apni/22536/api/citation-strings","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/reference/apni/22536/api/citation-strings"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/22536\",\n \"resources\": 1\n }\n },\n \"citation\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"citationHtml\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"action\": \"citation-strings\",\n \"result\": {\n \"citationHtml\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"citation\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X PUT ","type":"text"},{"text":"https://id.biodiversity.org.au/reference/apni/22536/api/citation-strings?apiKey=aaaaa-bbbbbb-eeee-ccccc-sssss","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/reference/apni/22536/api/citation-strings?apiKey=aaaaa-bbbbbb-eeee-ccccc-sssss"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/22536\",\n \"resources\": 1\n }\n },\n \"citation\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"citationHtml\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"action\": \"citation-strings\",\n \"result\": {\n \"citationHtml\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"citation\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.6.2. delete","type":"text"}]},{"type":"paragraph","content":[{"text":"GET delete","type":"text","marks":[{"type":"strong"}]},{"text":" tells you if a reference can be deleted. If not it gives a list of error messages explaining why not.","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE delete","type":"text","marks":[{"type":"strong"}]},{"text":" deletes the reference if it can be deleted. If not it gives a list of error messages explaining why not.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"55a21490-2321-436a-8509-618eaf31e70d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"You need to be an administrator, or administrator service to call this with the 'DELETE' method. Use your apiKey to authenticate.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Brief Reference object","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action: 'delete'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ok: true/false - false means you can’t delete this name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"errors: List - if ok is false this contains a list of error strings explaining the problem","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"if you are trying to delete and it fails (i.e. you didn’t check if you could delete it) you will get a 403 return code, with a payload containing error messages.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"reason - the reason this reference is being deleted.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"paragraph","content":[{"text":"Check if you can delete","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X GET ","type":"text"},{"text":"https://id.biodiversity.org.au/reference/apni/22536/api/delete.json","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/reference/apni/22536/api/delete.json"}}]}]}]},{"type":"paragraph","content":[{"text":"response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"reference\": {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/22536\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"citationHtml\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\"\n },\n \"action\": \"delete\",\n \"ok\": false,\n \"errors\": [\n \"There are 2379 instances for this reference.\"\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://id.biodiversity.org.au/reference/apni/22536/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/reference/apni/22536/api/delete?apiKey=aaaaa-bbbbbb-ccccc-ddddd-eeeee&reason=I+dont+like+it"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Non working response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"reference\": {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/22536\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"citationHtml\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\"\n },\n \"action\": \"delete\",\n \"ok\": false,\n \"errors\": [\n \"There are 2379 instances for this reference.\"\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Working response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"reference\": {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/22536\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\",\n \"citationHtml\": \"Brown, R. (1810), Prodromus Florae Novae Hollandiae\"\n },\n \"action\": \"delete\",\n \"ok\": true\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.6.3. move","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE move","type":"text","marks":[{"type":"strong"}]},{"text":" move all associated resources for a reference to another reference. This is typically used in de-duplicating references that have been entered multiple times. This action will:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"redirect the URI’s associated with the source reference to the target reference,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"move all instances, comments, external references, notes, to the target reference, then","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"delete the source reference.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This will delete the source reference. You need to be an administrator to do this, so you will need an apiKey if calling it from a service.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"target - the target reference id on the service, ie. the database ID (this is not intended for use externally)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"user - (optional) The user to blame, defaults to the administrator.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You use the resource URI as the ","type":"text"},{"text":"source","type":"text","marks":[{"type":"strong"}]},{"text":" reference and pass the target reference ID as a parameter.","type":"text"}]},{"type":"paragraph","content":[{"text":"example","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://id.biodiversity.org.au/reference/apni/22536/api/move?target=22537&apiKey=blah_blah_blah?user=fred","type":"text","marks":[{"type":"link","attrs":{"href":"https://id.biodiversity.org.au/reference/apni/22536/api/move?target=22537&apiKey=blah_blah_blah?user=fred"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"response","type":"text"}]},{"type":"paragraph","content":[{"text":"A brief target Reference object is returned along with the result \"ok\" to indicate success. If there are errors they will be in an errors field as a list.","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"reference\": {\n \"class\": \"au.org.biodiversity.nsl.Reference\",\n \"_links\": {\n \"permalink\": {\n \"link\": \"https://id.biodiversity.org.au/reference/apni/30623\",\n \"preferred\": true,\n \"resources\": 1\n }\n },\n \"citation\": \"Stearn, W.T. in Stearn, W.T. (ed.) (1978), European species of Allium and allied genera of Alliaceae: a synonymic enumeration. Annales Musei Goulandris 4\",\n \"citationHtml\": \"Stearn, W.T. in Stearn, W.T. (ed.) (1978), European species of Allium and allied genera of Alliaceae: a synonymic enumeration. Annales Musei Goulandris<\\u002fi> 4\"\n },\n \"action\": \"move\",\n \"ok\": true\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.6.4. deduplicate-marked","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE deduplicate-marked","type":"text","marks":[{"type":"strong"}]},{"text":" finds all references with duplicateOf set to another reference and calls the move action on it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"user - (optional) The user to blame, defaults to the administrator.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This will delete the duplicate references. You need to be an administrator to do this, so you will need an apiKey if calling it from a service.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"example","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://biodiversity.org.au/nsl/services/reference/api/deduplicate-marked?apiKey=blah_blah_blah?user=fred","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/reference/api/deduplicate-marked?apiKey=blah_blah_blah?user=fred"}}]}]}]},{"type":"paragraph","content":[{"text":"response","type":"text"}]},{"type":"paragraph","content":[{"text":"a list of de-duplicated reference DB IDs with an indication of success.","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"action\": \"deduplicate marked references\",\n \"count\": 140,\n \"references\": [\n {\n \"source\": 30695,\n \"target\": 30623,\n \"ok\": true\n },\n {\n \"source\": 30693,\n \"target\": 30623,\n \"ok\": true\n },\n {\n \"source\": 50954,\n \"target\": 44601,\n \"ok\": true\n },\n {\n \"source\": 38140,\n \"target\": 25636,\n \"ok\": true\n },\n {\n \"source\": 29860,\n \"target\": 23959,\n \"ok\": true\n },\n {\n \"source\": 34172,\n \"target\": 25636,\n \"ok\": true\n },\n {\n \"source\": 34173,\n \"target\": 25636,\n \"ok\": true\n },\n...\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.7. Author API V1.0","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.7.1. deduplicate","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE deduplicate","type":"text","marks":[{"type":"strong"}]},{"text":" Deduplicate author. Takes a duplicate author and replaces it with a target author. All References and Names that currently use the duplicate author will have the author replaced with the target author. The mapper is updated so that URL IDs are updated to refer to the target author. The duplicate author is then deleted from the database.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"user - (optional) The user to blame, defaults to the administrator.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This will delete the duplicate author. You need to be an administrator to do this, so you will need an apiKey if calling it from a service.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"example","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl -L -H \"Accept: application/json\" -X DELETE ","type":"text"},{"text":"https://biodiversity.org.au/nsl/services/author/apni/3456/api/deduplicate?target=12345&apiKey=blah_blah_blah&user=fred","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/author/apni/3456/api/deduplicate?target=12345&apiKey=blah_blah_blah&user=fred"}}]}]}]},{"type":"paragraph","content":[{"text":"response","type":"text"}]},{"type":"paragraph","content":[{"text":"The results of deduplicating the author.","type":"text"}]},{"type":"codeBlock","content":[{"text":"TODO","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.8. Suggestions API V1.0","type":"text"}]},{"type":"paragraph","content":[{"text":"The NSL infrastructure provides a number of simmple suggestions services as described in ","type":"text"},{"text":"http://nerderg.com/Simple+Suggestions+plugin","type":"text","marks":[{"type":"link","attrs":{"href":"http://nerderg.com/Simple+Suggestions+plugin"}}]}]},{"type":"paragraph","content":[{"text":"The simple suggestions service is open and provides a way to do a simple type ahead or suggestion for search results to do with names, references and authors in the NSL.","type":"text"}]},{"type":"paragraph","content":[{"text":"The suggestion service works on a set of subjects where you provide a search term, and the service gives a list of strings as a result set.","type":"text"}]},{"type":"paragraph","content":[{"text":"the basic structure of a suggestionservice URL is:","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://biodiversity.org.au/nsl/services/suggest/[subject]?term=[your search string]","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the jQuery-ui autocomplete widget you can add the suggestions to your web page with the following javascript:","type":"text"}]},{"type":"codeBlock","content":[{"text":" $(\".suggest\").each(function () {\n var action = $(this).data('subject');\n var quoted = $(this).data('quoted');\n var actionurl = baseContextPath + '/suggest/' + action;\n $(this).autocomplete({\n minLength: 1,\n source: actionurl,\n select: function (event, ui) {\n var qry = ui.item.value;\n if (quoted) {\n qry = '\"' + ui.item.value + '\"';\n }\n $(this).val(qry);\n event.cancel();\n }\n });\n });","type":"text"}]},{"type":"paragraph","content":[{"text":"You then just mark up you input text box like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"That says do a autocomplete here (class=\"suggest\") on subject \"apni-search\" and quote the result if clicked on.","type":"text"}]},{"type":"paragraph","content":[{"text":"The suggestion subjects are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apni-search - search APNI on full name as per the apni name search service","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apc-search - search APC on full name as per the search service","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"simpleName - search on simple name, returns all names that match","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acceptableName - search on simple or full name, only returns names that are deemed 'acceptable' see acceptable-name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"author - search for an author","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"publication - search for a publication","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"epithet - search for an epithet","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nameType - search on name types.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Most suggestion end points just return a simple list of names.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"https://biodiversity.org.au/nsl/services/suggest/simpleName?term=acacia%20dealbata%20sub","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/suggest/simpleName?term=acacia%20dealbata%20sub"}}]}]},{"type":"paragraph","content":[{"text":"Results","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n \"Acacia dealbata subsp. A\",\n \"Acacia dealbata subsp. B\",\n \"Acacia dealbata subsp. dealbata\",\n \"Acacia dealbata subsp. subalpina\"\n]","type":"text"}]},{"type":"paragraph","content":[{"text":"acceptableName returns a list of JSON objects of name and link, where link is the ID or URI of the name.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"https://biodiversity.org.au/nsl/services/suggest/acceptableName?term=acacia%20dealbata%20sub","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/nsl/services/suggest/acceptableName?term=acacia%20dealbata%20sub"}}]}]},{"type":"paragraph","content":[{"text":"Results","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"name\": \"Acacia dealbata subsp. A\",\n \"link\": \"https://id.biodiversity.org.au/name/apni/232073\"\n },\n {\n \"name\": \"Acacia dealbata subsp. B\",\n \"link\": \"https://id.biodiversity.org.au/name/apni/232074\"\n },\n {\n \"name\": \"Acacia dealbata Link subsp. dealbata\",\n \"link\": \"https://id.biodiversity.org.au/name/apni/141782\"\n },\n {\n \"name\": \"Acacia dealbata subsp. subalpina Tindale & Kodela\",\n \"link\": \"https://id.biodiversity.org.au/name/apni/152864\"\n }\n]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.9. Tree Structure V1.0","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Under Construction","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This documentation is under construction. We understand it needs extending and improving, but we thought we’d let you see what we’ve got so far.","type":"text"}]},{"type":"paragraph","content":[{"text":"Our tree component stores taxonomic trees, and potentially more. It can store arbitrary document-structured data, such as profile data, whose elements are identified by RDF classes and predicates.","type":"text"}]},{"type":"paragraph","content":[{"text":"The tree component holds a full history of every change made to any part of the tree.","type":"text"}]},{"type":"paragraph","content":[{"text":"The principal design goal is that no persistent ","type":"text"},{"text":"[1]","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":" node of the tree should ever change. That is: given a publically available node id, the entire document at that node - the node itself and all nodes below it - should be stable.","type":"text"}]},{"type":"paragraph","content":[{"text":"The purpose of this is to permit node ids to be used as reliable references. Using a node id, an author can declare that they are using a particular name in a particular classification at a particular time, and that declaration will not change its meaning as our classifications are maintained and updated.","type":"text"}]},{"type":"paragraph","content":[{"text":"To make this possible, nodes are never changed - they are replaced by new nodes. ","type":"text"},{"text":"[2]","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":". This replacement propagates upward through the tree, resulting in a new root node whose entire document includes the new node in place of the previous one, by way of a series of new nodes along the path from the root to the changed node. In our code, we call this process \"versioning\".","type":"text"}]},{"type":"paragraph","content":[{"text":"The process is somewhat inspired by Git and other version-management tools. We do not use hashes to identify subdocuments, however, just the nodes themselves. We also do not use timestamps to manage or identify versions of a node - the structure over time is directly in the nodes and the links between them. ","type":"text"},{"text":"[3]","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Our algorithms permit any number of changes to be made to a tree simultaneously. This permits, for instance, a name to be moved from one higher taxon to another as a single operation. Certain bulk updates which have had to be done as part of the maintenance of the classification appear as single changes affecting almost all nodes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Our algorithms permit a node to be used as a subnode of any number of other nodes (provided no cycles are formed). This would permit in future a user to create their own trees that connect together fragments of other trees.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.9.1. Overall Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Figure 14. Tree overall structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Our data consists of a number of tree ","type":"text"},{"text":"Nodes","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Nodes are linked into directed acyclic graphs with ","type":"text"},{"text":"Links","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Nodes each belongs to an ","type":"text"},{"text":"Arrangement","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Node lifecycle is recorded in ","type":"text"},{"text":"Events","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Nodes and Links","type":"text"}]},{"type":"paragraph","content":[{"text":"A node \"is\" its content and the set of links of which it is the supernode (and therefore the nodes below them). To put it another way, links are ","type":"text"},{"text":"part of","type":"text","marks":[{"type":"em"}]},{"text":" the node above them, a node ","type":"text"},{"text":"has","type":"text","marks":[{"type":"em"}]},{"text":" the links of which it is the supernode. A change to a link is a change to the node above it, not to the node below it. Nodes, in a sense, do not care where they are placed, they include what is placed under them.","type":"text"}]},{"type":"paragraph","content":[{"text":"Links, therefore, are not separate from nodes and there is not an api to retrieve them separately. A link’s identity is its supernode and its ","type":"text"},{"text":"linkSeq","type":"text","marks":[{"type":"strong"}]},{"text":". A node’s links are guaranteed to have unique ","type":"text"},{"text":"linkSeq","type":"text","marks":[{"type":"strong"}]},{"text":" numbers but are not guaranteed to have consecutive ","type":"text"},{"text":"linkSeq","type":"text","marks":[{"type":"strong"}]},{"text":" numbers. This makes it possible to work out what about a node has changed from one version to the next - matching ","type":"text"},{"text":"linkSeq","type":"text","marks":[{"type":"strong"}]},{"text":" numbers are \"the same\" link. If a subnode is deleted from a node, what will happen is that a new version of the node will be created with that ","type":"text"},{"text":"linkSeq","type":"text","marks":[{"type":"strong"}]},{"text":" missing.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Arrangements","type":"text"}]},{"type":"paragraph","content":[{"text":"We use the term \"arrangement\" in the sense of \"an arrangement of nodes\". The term \"Tree\" or \"Classification\" is used more strictly - it means an arrangement that has a specific higher-order structure. Most of the arrangements accessible by the public API are in fact classifications. Other arrangements are used internally.","type":"text"}]},{"type":"paragraph","content":[{"text":"Every node belongs to one Arrangement.","type":"text"}]},{"type":"paragraph","content":[{"text":"Every arrangement has one 'top' node.","type":"text"}]},{"type":"paragraph","content":[{"text":"Arrangements are where permissions and authorisation is done. We do not have an access control list on every node - it’s done at the arrangement layer.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Lifecycle","type":"text"}]},{"type":"paragraph","content":[{"text":"A node has two events in its lifecycle. It changes from being a draft node to being a (current) persistent node, and it changes from being a current node to being a replaced node. The ","type":"text"},{"text":"checkedInAt","type":"text","marks":[{"type":"strong"}]},{"text":" attribute links to the ","type":"text"},{"text":"Event","type":"text","marks":[{"type":"strong"}]},{"text":" at which a node is made persistent, and the ","type":"text"},{"text":"replacedAt","type":"text","marks":[{"type":"strong"}]},{"text":" attribute links to the ","type":"text"},{"text":"Event","type":"text","marks":[{"type":"strong"}]},{"text":" at which a node became replaced.","type":"text"}]},{"type":"paragraph","content":[{"text":"Most ","type":"text"},{"text":"Events","type":"text","marks":[{"type":"strong"}]},{"text":" have many nodes checked in and replaced by them. Events have a timestamp, and so a node is current from the timestamp of it’s ","type":"text"},{"text":"checkedInAt","type":"text","marks":[{"type":"strong"}]},{"text":" event up to but not including the timestamp of its ","type":"text"},{"text":"replacedAt","type":"text","marks":[{"type":"strong"}]},{"text":" event.","type":"text"}]},{"type":"paragraph","content":[{"text":"Most of the time, users want to work with the set of current nodes in an arrangement, and our system is optimised towards that. From the point of view of our editors, the set of current nodes \"is\" the tree.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"History","type":"text"}]},{"type":"paragraph","content":[{"text":"Corresponding to the lifecycle event attributes, a node also has a ","type":"text"},{"text":"prev","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"next","type":"text","marks":[{"type":"strong"}]},{"text":" attribute (which we inconsistently call its ","type":"text"},{"text":"copyOf","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"replacedBy","type":"text","marks":[{"type":"strong"}]},{"text":" node in some places). Nodes and links also have a boolean ","type":"text"},{"text":"synthetic","type":"text","marks":[{"type":"strong"}]},{"text":" attribute.","type":"text"}]},{"type":"paragraph","content":[{"text":"Most of the time, nodes are updated because the nodes beneath them have been updated - a change has been rippled \"up the tree\" by the versioning algorithm. In these cases, the ","type":"text"},{"text":"next","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"prev","type":"text","marks":[{"type":"strong"}]},{"text":" attributes will form a doubly-linked list and the node and its links will be marked 'synthetic'.","type":"text"}]},{"type":"paragraph","content":[{"text":"Cases where this is not true usually indicates a user edit - that something interesting has happened. A newly created node has no 'prev'. If a node is used in a different tree, and then in that different tree edits are performed, then the new node will have a 'prev' of the node from which it was copied, but the node from which it was copies will not indicate that the new node is its 'next'. Many cases are possible, and graphically showing them to a user in a meaningful and useful way … is something that would be very nice to have.","type":"text"}]},{"type":"paragraph","content":[{"text":"And so to find points in a node’s history where the node itself has been edited for some reason, search for nodes whose ","type":"text"},{"text":"synthetic","type":"text","marks":[{"type":"strong"}]},{"text":" attribute is ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"A node has a ","type":"text"},{"text":"next","type":"text","marks":[{"type":"strong"}]},{"text":" node if and only if it has a ","type":"text"},{"text":"replacedAt","type":"text","marks":[{"type":"strong"}]},{"text":" event. We therefore have a special ","type":"text"},{"text":"End Node","type":"text","marks":[{"type":"strong"}]},{"text":" whose id is 0 and whose RDF identifier is a constant belonging to the BOA RDF vocabulary ","type":"text"},{"text":"[4]","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":". This node has to belong to an arrangement, and so arrangement 0 is the ","type":"text"},{"text":"End Tree","type":"text","marks":[{"type":"strong"}]},{"text":" consisting only of that single node, also having a constant id that is part of the BOA vocabulary ","type":"text"},{"text":"[5]","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":". From the point of view of the semantic web, the end node and end tree are each the same semantic-web \"thing\" wherever they appear.","type":"text"}]},{"type":"paragraph","content":[{"text":"The primary reason for this is internal - it is so that SQL queries that look at node histories and changes don’t have to outer join on ","type":"text"},{"text":"node.next_node_id","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.9.2. Arrangement, Node, and Link internal types","type":"text"}]},{"type":"paragraph","content":[{"text":"Certain attributes of Arrangements, Nodes, and Links alter how they are treated internally by the system at the lower level of processing. That is, they do not have taxonomic meaning. These types are separate from the RDF types, which are discussed in [Node and Link RDF types].","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Arrangement types","type":"text"}]},{"type":"paragraph","content":[{"text":"An arrangement may be","type":"text"}]},{"type":"paragraph","content":[{"text":"E","type":"text","marks":[{"type":"strong"}]},{"text":": The End Tree","type":"text"}]},{"type":"paragraph","content":[{"text":"There is only ever one end tree, and it has an id of 0. Discussed in History","type":"text"}]},{"type":"paragraph","content":[{"text":"P","type":"text","marks":[{"type":"strong"}]},{"text":": Public classification","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the most usual type that a user of our API will deal with. Classification trees have a specific higher-level structure discussed in Classification trees.","type":"text"}]},{"type":"paragraph","content":[{"text":"U","type":"text","marks":[{"type":"strong"}]},{"text":": User","type":"text"}]},{"type":"paragraph","content":[{"text":"User trees will be made up of fragments of other trees.","type":"text"}]},{"type":"paragraph","content":[{"text":"B","type":"text","marks":[{"type":"strong"}]},{"text":": Bookmark","type":"text"}]},{"type":"paragraph","content":[{"text":"These will consist of one (or perhaps several) nodes that \"track\" nodes in other arrangements.","type":"text"}]},{"type":"paragraph","content":[{"text":"Z","type":"text","marks":[{"type":"strong"}]},{"text":": System temporary","type":"text"}]},{"type":"paragraph","content":[{"text":"These are used internally to perform certain operations and discarded.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Node types","type":"text"}]},{"type":"paragraph","content":[{"text":"A node may be","type":"text"}]},{"type":"paragraph","content":[{"text":"S","type":"text","marks":[{"type":"strong"}]},{"text":": System node","type":"text"}]},{"type":"paragraph","content":[{"text":"These are nodes which are used internally by the system, but which do not have scientific or taxonomic meaning.","type":"text"}]},{"type":"paragraph","content":[{"text":"T","type":"text","marks":[{"type":"strong"}]},{"text":": Taxonomic node","type":"text"}]},{"type":"paragraph","content":[{"text":"This node will be associated with a name, and usually with an instance.","type":"text"}]},{"type":"paragraph","content":[{"text":"D","type":"text","marks":[{"type":"strong"}]},{"text":": Document node","type":"text"}]},{"type":"paragraph","content":[{"text":"These nodes will be collections of value nodes and other document nodes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Z","type":"text","marks":[{"type":"strong"}]},{"text":": Temp node","type":"text"}]},{"type":"paragraph","content":[{"text":"These are nodes used internally to perform certain operations and discarded.","type":"text"}]},{"type":"paragraph","content":[{"text":"V","type":"text","marks":[{"type":"strong"}]},{"text":": Value node","type":"text"}]},{"type":"paragraph","content":[{"text":"A value node either has a literal value or is a semantic web URI.","type":"text"},{"type":"hardBreak"},{"text":"Value nodes never change, are never replaced, and never have subnodes ","type":"text"},{"text":"[6]","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":". Value nodes are always attached to supernodes with fixed links. In RDF, value nodes do not appear as nodes in their own right with an identifying URI; they are instead rendered as properties on the Document or Taxonomic node to which they are attached.","type":"text"}]},{"type":"paragraph","content":[{"text":"A node may also be synthetic (or not). This is discussed in History.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Link types","type":"text"}]},{"type":"paragraph","content":[{"text":"A link has a ","type":"text"},{"text":"versioning Method","type":"text","marks":[{"type":"strong"}]},{"text":". This may be","type":"text"}]},{"type":"paragraph","content":[{"text":"V","type":"text","marks":[{"type":"strong"}]},{"text":": Versioning","type":"text"}]},{"type":"paragraph","content":[{"text":"If the subnode of the link is replaced with a new version, then the supernode must be replaced with a new version.","type":"text"},{"type":"hardBreak"},{"text":"This is the usual case. Versioning links are how the normal \"changes must be rippled up\" operation of the system works. ","type":"text"},{"text":"If the supernode of a versioning link is a current node, then the subnode will also be current.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"F","type":"text","marks":[{"type":"strong"}]},{"text":": Fixed","type":"text"}]},{"type":"paragraph","content":[{"text":"If the subnode of the link is replaced with a new version, then do not ripple the change up.","type":"text"},{"type":"hardBreak"},{"text":"Value nodes are always attached to ther supernodes with fixed links. Aside from this, we do not use fixed links at present, although they may be an option in user-created arrangements. If an arrangement uses fixed links, then it is not possible to identify nodes currently attached to the root of the tree without doing a tree-walk.","type":"text"}]},{"type":"paragraph","content":[{"text":"T","type":"text","marks":[{"type":"strong"}]},{"text":": Tracking","type":"text"}]},{"type":"paragraph","content":[{"text":"If the subnode of the link is replaced with a new version, then update the link to refer to the new version without making a new version of the supernode.","type":"text"},{"type":"hardBreak"},{"text":"The subnode of a tracking link is always a ","type":"text","marks":[{"type":"strong"}]},{"text":"current","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" node","type":"text","marks":[{"type":"strong"}]},{"text":". This even applies to replaced (old) nodes. The tracking links of replaced nodes are not frozen in time because \"where the tracking link happened to be at the time this node was replaced\" doesn’t mean anything that could not be meant by using a versioning link.","type":"text"}]},{"type":"paragraph","content":[{"text":"We use tracking links to provide a persistent handles to nodes that change over time, to provide a persistent name for whatever the current version of some other node might be. They do not form part of taxonomic trees ","type":"text"},{"text":"[7]","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":". See Classification trees for the most important use of this currently.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.9.3. Node content and Node and Link RDF types","type":"text"}]},{"type":"paragraph","content":[{"text":"Nodes and links have attributes that carry data. These attributes are not of interest to the low-level maintenance of the tree structure, but they are of interest to whatever it is that is using the tree to store data.","type":"text"}]},{"type":"paragraph","content":[{"text":"Firstly, and most obviously, T type nodes usually hold a name and instance id. In NSL, we have a 'Name Tree' whose main job is to provide Phylum and Family for generic and subgeneric names so that suitable output can be produced. We also have an 'APC' classification whose job is to hold accepted names and taxa for the Australian Plant Census.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parallel with the name and instance ids, we also have name and taxon URIs. Name and taxon URIs match the name and instance ids when these ids refer to names held in the local shard. However, having URIs permit us to create branches that terminate at names and taxa that are foreign ids.","type":"text"}]},{"type":"paragraph","content":[{"text":"Along with name and taxon URIs, we also have a 'Resource' URI. This is mainly intended for V (value) type nodes. In RDF, a value may be a types primitive, or is may be a \"resource\" - a URI.","type":"text"}]},{"type":"paragraph","content":[{"text":"Nodes and links also have a Type URI. In RDF, the link type becomes the RDF predicate, and the node type becomes the type of a typed primitive (where the node is a value), or is used as the OWL class of the node.","type":"text"}]},{"type":"paragraph","content":[{"text":"The uri type may have meaning within the tree. In particular, our APC tree has nodes of type ","type":"text"},{"text":"APCConcept","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"APCExcluded","type":"text","marks":[{"type":"code"}]},{"text":", and ","type":"text"},{"text":"DeclaredBT","type":"text","marks":[{"type":"code"}]},{"text":". Their meanings are described in apc.","type":"text"}]},{"type":"paragraph","content":[{"text":"Physically, our URIs are broken into a namespace and a an id. These are named ","type":"text"},{"text":"‹Name|Taxon|Resource›UriNsPart","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"‹Name|Taxon|Resource›UriIdPart","type":"text","marks":[{"type":"code"}]},{"text":". The original purpose for splitting the URIs in this way was to make it easier to generate RDF. However, now we use D2R to generate the RDF, which does not use this feature to label the URI prefixes, and this design may be unnecessary.","type":"text"}]},{"type":"paragraph","content":[{"text":"Uri namespace 0 is always the 'empty' namespace. A namespace of 0 means that the entire URI is in the 'UriIdPart'. The purpose of this is so that in SQL you don’t need to outer join the namespace table.","type":"text"}]},{"type":"paragraph","content":[{"text":"Uri namespace 1 is always the boatree namespace `http://biodiversity.org.au/voc/boa/Tree#'. This namespace is the prefix for internal artifacts when they are exposed as RDF.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.9.4. Classification trees","type":"text"}]},{"type":"paragraph","content":[{"text":"Classification trees are trees that have a specific higher-order structure, a specific way of using the lower-level data structure and algorithms.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Arrangement of a classification tree has type ","type":"text"},{"text":"P","type":"text","marks":[{"type":"code"}]},{"text":" - public classification. The arrangement always has a label, and that label becomes the suffix of the persistent URI identifying the classification.","type":"text"}]},{"type":"paragraph","content":[{"text":"The top node of the arrangement is a system node ","type":"text"},{"text":"S","type":"text","marks":[{"type":"code"}]},{"text":". This node has RDF type ","type":"text"},{"text":"classification-node","type":"text","marks":[{"type":"code"}]},{"text":" and holds ","type":"text"},{"text":"one","type":"text","marks":[{"type":"strong"}]},{"text":" tracking link to a taxonomic node ","type":"text"},{"text":"T","type":"text","marks":[{"type":"code"}]},{"text":" of RDF type 'classification-root'.","type":"text"}]},{"type":"paragraph","content":[{"text":"The classification root is not part of the taxonomy, does not have a name or an instance, and it may have been a mistake to make it a taxonomic node rather than a system node. We have an unnamed root node because","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"having a single taxon at the top level would make it impossible to change the name at the top of the taxonomy while recording the history correctly. If our taxonomists were to decide to \"push down\" the top name, the only way to do it would be to change the name of the top node and add a new node under it with the previous name. The versioning history would not reflect what actually happened - it would not show that the top node got pushed down and that the new top node is new. Instead it would show that the 'Plantae' APC taxon had its name changed to 'Eukaryota' (or whatever). This would simply be wrong - the Plantae concept would not have changed, it would just have been moved.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"some taxonomies have multiple taxa at the top level that are not organised into a higher classification. For instance, AFD has 'Animalia' and 'Prototheria' at the top level. It would - again - simply be wrong to insist on a top level taxon of Eukaryota or \"All life on Earth\", because these names are ","type":"text"},{"text":"not part of the Australian Faunal Directory","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The effect of this is that changes in classification trees result in a new ","type":"text"},{"text":"classification-root","type":"text","marks":[{"type":"code"}]},{"text":" node, and those nodes form a single line of history that can be navigated by looking at their ","type":"text"},{"text":"next","type":"text","marks":[{"type":"code"}]},{"text":"/","type":"text"},{"text":"prev","type":"text","marks":[{"type":"code"}]},{"text":" attributes and the timestamps on their associated ","type":"text"},{"text":"Events","type":"text","marks":[{"type":"code"}]},{"text":". The single ","type":"text"},{"text":"classification-node","type":"text","marks":[{"type":"code"}]},{"text":" acts as a bookmark - its single sublink always points to the current (most recent) classification root.","type":"text"}]},{"type":"paragraph","content":[{"text":"There are a couple more rules:","type":"text"}]},{"type":"paragraph","content":[{"text":"A classification only ever has one current node for any given name. That is - names appear only once. Consequently, our API for classification is is built entirely around names: \"add this name to that name as an excluded name\" and so on.","type":"text"}]},{"type":"paragraph","content":[{"text":"Every node in a classification arrangement belongs to that arrangement. The purpose of this is to expedite the most important and common operation: find a name’s current placement in a classification.","type":"text"}]},{"type":"paragraph","content":[{"text":"IF","type":"text","marks":[{"type":"strong"}]},{"text":" a node","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"has the name you are looking for; AND","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"belongs to the classification you are searching; AND","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"is current","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"THEN","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"it is the current placement of that name in that classification","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"it will have ","type":"text"},{"text":"one","type":"text","marks":[{"type":"strong"}]},{"text":" superlink that links it to a node that","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"also belongs to the classification; AND","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"is current","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Both of these conditions need to be checked. Nodes may be included as subnodes in user classifications, and nodes will be placed under multiple copies of a supernode when sibling nodes are updated. However, only one will be current.","type":"text"}]},{"type":"paragraph","content":[{"text":"And remember - this only applies to Arrangements of type ","type":"text"},{"text":"P","type":"text","marks":[{"type":"code"}]},{"text":", which are maintained in such a way as these rules are followed.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.10. Tree API for JSON V1.0","type":"text"}]},{"type":"paragraph","content":[{"text":"The tree JSON API is built to work with AngularJS and similar platforms.","type":"text"}]},{"type":"paragraph","content":[{"text":"This API comprises three main components: * the tree view services; and * JSON views of nodes, arrangements, and events; * the tree edit services, which require a user login","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TODO: put in correct URLs for these services **","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.10.1. tree view services","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"listNamespaces","type":"text"}]},{"type":"paragraph","content":[{"text":"GET (no parameters)","type":"text","marks":[{"type":"strong"}]},{"text":" to list the known namespaces.","type":"text"}]},{"type":"codeBlock","content":[{"text":"http://[your uri]/TreeJsonView/listNamespaces","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A JSON array of information about namespaces","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example 1","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl --noproxy \\* -L -H \"Accept: application/json\" -X GET '","type":"text"},{"text":"http://localhost:8080/services/TreeJsonView/listNamespaces","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8080/services/TreeJsonView/listNamespaces"}}]},{"text":"'","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"class\":\"au.org.biodiversity.nsl.Namespace\",\n \"name\":\"AMANI\",\n \"descriptionHtml\":\"AMANI<\\u002fb>: Australian Marine Algal Names Index\"\n },\n {\n \"class\":\"au.org.biodiversity.nsl.Namespace\",\n \"name\":\"AUSMOSS\",\n \"descriptionHtml\":\"AUSMOSS<\\u002fb>: Australian Mosses\"\n },\n {\n \"class\":\"au.org.biodiversity.nsl.Namespace\",\n \"name\":\"APNI\",\n \"descriptionHtml\":\"APNI<\\u002fb>: Australian Plant Names Index\"\n }\n]","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"listClassifications","type":"text"}]},{"type":"paragraph","content":[{"text":"GET namespace","type":"text","marks":[{"type":"strong"}]},{"text":" to list the classifications in a namespace","type":"text"}]},{"type":"codeBlock","content":[{"text":"http://[your uri]/TreeJsonView/listClassifications?namespace=APNI","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"namespace: the name of a namespace","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A JSON array of the URIs of classifications in the namespace","type":"text"}]}]}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"Example 1","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl --noproxy \\* -L -H \"Accept: application/json\" -X GET '","type":"text"},{"text":"http://localhost:8080/services/TreeJsonView/listClassifications?namespace=APNI","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8080/services/TreeJsonView/listClassifications?namespace=APNI"}}]},{"text":"'","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n \"http://localhost:7070/nsl-mapper/boa/tree/apni/1133571\",\n \"http://localhost:7070/nsl-mapper/boa/tree/apni/3029293\",\n \"http://localhost:7070/nsl-mapper/boa/tree/apni/4950638\",\n \"http://localhost:7070/nsl-mapper/boa/tree/apni/1019\"\n]","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"listWorkspaces","type":"text"}]},{"type":"paragraph","content":[{"text":"GET namespace","type":"text","marks":[{"type":"strong"}]},{"text":" to list the workspaces in a namespace","type":"text"}]},{"type":"codeBlock","content":[{"text":"http://[your uri]/TreeJsonView/listWorkspaces?namespace=APNI","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"namespace: the name of a namespace","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A JSON array of the URIs of workspaces in the namespace","type":"text"}]}]}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"Example 1","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"curl --noproxy \\* -L -H \"Accept: application/json\" -X GET '","type":"text"},{"text":"http://localhost:8080/services/TreeJsonView/listWorkspaces?namespace=APNI","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8080/services/TreeJsonView/listWorkspaces?namespace=APNI"}}]},{"text":"'","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n \"http://localhost:7070/nsl-mapper/boa/tree/apni/4952854\",\n \"http://localhost:7070/nsl-mapper/boa/tree/apni/4952889\"\n]","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"permissions","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.10.2. JSON views of nodes, arrangements, and events","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.10.3. Tree Edit Services","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"createWorkspace","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"deleteWorkspace","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"updateWorkspace","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.11. SPARQL and the semantic web","type":"text"}]},{"type":"paragraph","content":[{"text":"The NSL system provides a SPARQL endpoint which runs queries written in \"SPARQL Protocol and Semantic Query Language\", and which serves NSL data as sets of RDF \"triples\".","type":"text"}]},{"type":"paragraph","content":[{"text":"This endpoint is located at ","type":"text"},{"text":"https://biodiversity.org.au/sparql","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/sparql"}}]},{"text":" . Use it as per ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.w3.org/TR/rdf-sparql-protocol/"}},{"text":" . In a nutshell: pass an encoded SPARQL query as a parameter named 'query' (GET or POST).","type":"text"}]},{"type":"paragraph","content":[{"text":"The endpoint will respond with an RDF document by default, but can respond with various other formats as specificed in the HTTP ","type":"text"},{"text":"Accept","type":"text","marks":[{"type":"code"}]},{"text":" header. Our endpoint is a Jena Joseki instance. More details on what Joseki will accept may be available at ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://sourceforge.net/projects/joseki/"}},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"The query itself is written in SPARQL, a query language very similar to SQL. Documentation is here ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.w3.org/TR/2013/REC-sparql11-query-20130321/"}},{"text":" . Although this document may show some SPARQL examples, it is not intended as a SPARQL primer. The main focus here is a description of what data we have available at the sparql endpoint.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.11.1. Linked data and semantic web integration","type":"text"}]},{"type":"paragraph","content":[{"text":"The triples available at our endpoint are intended to be resolvable linked data URIs.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Static vocabulary","type":"text"}]},{"type":"paragraph","content":[{"text":"Vocabulary items - names of predicates, enumerated values - resolve to ontology documents either externally available or hosted at ","type":"text"},{"text":"http://biodiversity.org.au/voc/","type":"text","marks":[{"type":"link","attrs":{"href":"http://biodiversity.org.au/voc/"}}]},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"For instance, some of our rdf objects have an ","type":"text"},{"text":"rdf:type","type":"text","marks":[{"type":"code"}]},{"text":" of ","type":"text"},{"text":"http://biodiversity.org.au/voc/boa/InstanceNote#Key","type":"text","marks":[{"type":"code"}]},{"text":" . An http GET of this url will result in a redirect to ","type":"text"},{"text":"http://biodiversity.org.au/voc/boa/InstanceNote.rdf","type":"text","marks":[{"type":"link","attrs":{"href":"http://biodiversity.org.au/voc/boa/InstanceNote.rdf"}}]},{"text":", which is the document containing the definition of that rdf class along with other things.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n Key\n Instance Note Key\n \n
\n
Instance Note Key
\n
\n comment, distribution, etymology, etc. These keys correspond to\n various bits of data that were captured during the import process.\n
\n
\n URI Pattern: http://biodiversity.org.au/boa.voc.site.instance-note-key/id\n
\n
\n \n","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Data items","type":"text"}]},{"type":"paragraph","content":[{"text":"Entities corresponding to data in our system are identified by NSL identifiers, eg: ","type":"text"},{"text":"http://id.biodiversity.org.au/name/apni/106541","type":"text","marks":[{"type":"code"}]},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"Entered into a web browser (eg, by clicking the link above), these identifiers result in a linked data 303 redirect to a html page supplied by our service layer.","type":"text"}]},{"type":"paragraph","content":[{"text":"However, if the requested content type (the HTTP ","type":"text"},{"text":"Accept","type":"text","marks":[{"type":"code"}]},{"text":" header) is ","type":"text"},{"text":"application/rdf+xml","type":"text","marks":[{"type":"code"}]},{"text":", or if an ","type":"text"},{"text":".rdf","type":"text","marks":[{"type":"code"}]},{"text":" suffix is appended, then this will result in a 303 redirect to the sparql endpoint. In this particular case, the redirect will be to ","type":"text"},{"text":"https://biodiversity.org.au/sparql/?query=DESCRIBE+%3Chttp://id.biodiversity.org.au/name/apni/106541%3E","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/sparql/?query=DESCRIBE+%3Chttp://id.biodiversity.org.au/name/apni/106541%3E"}}]},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"This has the effect of sending the query","type":"text"}]},{"type":"codeBlock","content":[{"text":"DESCRIBE ","type":"text"}]},{"type":"paragraph","content":[{"text":"To the sparql endpoint, which responds with an RDF document produced by Joseki.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n \n \n 106541\n <scientific><name id='106541'><scientific><name id='104277'><element>Leucopogon</element></name></scientific> <element>acicularis</element> <authors><author id='1531' title='Bentham, G.'>Benth.</author></authors></name></scientific>\n \n \n \n Leucopogon acicularis Benth.\n \n 52832\n \n 106541\n \n acicularis\n \n \n \n \n \n \n Leucopogon acicularis\n NAME\n \n \n PLANT_NAME\n <scientific><name id='106541'><scientific><name id='104277'><element>Leucopogon</element></name></scientific> <element>acicularis</element></name></scientific>\n 52832\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"That is: linked data for data items is simply served up from our sparql endpoint, via HTTP redirects.","type":"text"}]},{"type":"paragraph","content":[{"text":"The goal of this \"round trip\" integration of the sparql service and semantic web standards is that our content should be machine-friendly. It should be possible for tools like Protege, web-based semantic web browsers, even reasoning engines, to be able to work over our content. It should be possible to mount our SPARQL endpoint as a named graph in an external JENA installation, and for queries run against that external installation to simply work.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.11.2. Overall content","type":"text"}]},{"type":"paragraph","content":[{"text":"The triples available at our sparql endpoint are organised into named graphs. The default graph contains triples describing what named graphs are available. The intent of doing this is that a simple ","type":"text"},{"text":"SELECT * where { ?s ?p ?o }","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"will pull back useful information without the server attempting to serve up the entire content of our data in response.","type":"text"}]},{"type":"paragraph","content":[{"text":"A more useful organisation of this data can be gotten by way of","type":"text"}]},{"type":"codeBlock","content":[{"text":"prefix g: \n\nselect *\nwhere {\n ?uri a g:GraphURI .\n ?uri ?p ?o .\n}\nORDER BY ?uri ?p","type":"text"}]},{"type":"paragraph","content":[{"text":"(link)","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/sparql/?output=text&query=prefix%20g%3A%20%3Chttp%3A%2F%2Fbiodiversity.org.au%2Fvoc%2Fgraph%2FGRAPH%23%3E%0A%0Aselect%20*%0Awhere%20%7B%20%0A%20%20%20%20%3Furi%20a%20g%3AGraphURI%20.%0A%20%20%20%20%3Furi%20%3Fp%20%3Fo%20.%0A%7D%0AORDER%20BY%20%3Furi%20%3Fp"}}]}]},{"type":"paragraph","content":[{"text":"Or","type":"text"}]},{"type":"codeBlock","content":[{"text":"prefix dcterms: \nprefix g: \n\nselect *\nwhere {\n ?uri a g:GraphURI .\n OPTIONAL { ?uri dcterms:title ?title } .\n}\nORDER BY ?uri","type":"text"}]},{"type":"paragraph","content":[{"text":"(link)","type":"text","marks":[{"type":"link","attrs":{"href":"https://biodiversity.org.au/sparql/?output=text&query=prefix%20dcterms%3A%20%3Chttp%3A%2F%2Fpurl.org%2Fdc%2Fterms%2F%3E%0Aprefix%20g%3A%20%3Chttp%3A%2F%2Fbiodiversity.org.au%2Fvoc%2Fgraph%2FGRAPH%23%3E%0A%0Aselect%20*%0Awhere%20%7B%20%0A%20%3Furi%20a%20g%3AGraphURI%20.%0A%20OPTIONAL%20%7B%20%3Furi%20dcterms%3Atitle%20%3Ftitle%20%20%7D%20.%0A%7D%0AORDER%20BY%20%3Furi"}}]}]},{"type":"paragraph","content":[{"text":"Table 1. Named graphs available at ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://biodiversity.org.au"}},{"text":" ","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"a03e541c-c4c4-4d9d-a14c-eddd1f50d81e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#57d9a3","rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"Graph URI","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#57d9a3","rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"title","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:AFD_PRF","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"AFD profile data","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:AFD_PUB_CIT","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"AFD Publication Citations","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:AFD_TAX_CON","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"AFD Taxa","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:AFD_TAX_NAM","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"AFD Names","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:AFD_TREE","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"AFD Taxonomy","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:APC_TREE","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"APC Taxonomy","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:APNI_PRF","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"APNI profile data","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:APNI_PUB_CIT","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"APNI Publication Citations","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:APNI_TAX_CON","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"APNI taxa","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:APNI_TAX_NAM","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"APNI Names","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:APNI_TREE","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Taxonomy according to the reference","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:COL_TAX_CON","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Accepted names and synonyms in the Catalogue of Life","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:COL_TAX_NAM","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Taxon names in Catalogue of Life that do not appear elsewhere in our data.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:NSL_APNI","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"NSL APNI","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:NSL_OZMOSS","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"NSL OZMOSS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:afd","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"AFD complete","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:apni","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"APNI complete","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:col","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"COL complete","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:dc_voc","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Dublin Core vocabulary","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:dwc_voc","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Darwin Core vocabulary","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:ibis_voc","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Complete IBIS vocabulary","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:ibis_voc_local","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"IBIS vocabulary","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:meta","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Service metadata","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:names","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"All names","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:nsl","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"National Species List","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:taxa","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"All taxa","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"g:tdwg_voc","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"TDWG Vocabulary","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Vocabulary and metadata","type":"text"}]},{"type":"paragraph","content":[{"text":"Our sparql instance contains rdf ontologies for the various vocabularies we use. That is: our sparql store loads a ","type":"text"},{"text":"copy","type":"text","marks":[{"type":"strong"}]},{"text":" of the linked data ontology documents. With this content, a sparql query can pull back predicate labels and descriptions.","type":"text"}]},{"type":"paragraph","content":[{"text":"g:ibis_voc_local","type":"text","marks":[{"type":"code"}]},{"text":" contains only those terms defined at ","type":"text"},{"text":"biodiversity.org.au`, and ","type":"text","marks":[{"type":"code"}]},{"text":"g:ibis_voc`` is the union of all the vocabulary graphs and is probably the most useful. For instance, to list all classes defined in all vocabularies loaded into the sparql dataset:","type":"text"}]},{"type":"codeBlock","content":[{"text":"prefix xs: \nprefix rdf: \nprefix rdfs: \nprefix owl: \nprefix dc: \nprefix dcterms: \nprefix g: \n\nselect ?schemaLabel ?uri ?label\nwhere {\n graph g:ibis_voc {\n {\n { ?uri a owl:class . }\n UNION { ?uri a owl:Class . }\n UNION { ?uri a rdfs:Class . }\n }\n OPTIONAL {\n ?uri rdfs:isDefinedBy ?schema .\n {\n { ?schema rdfs:label ?schemaLabel . }\n UNION\n { ?schema dcterms:title ?schemaLabel . }\n }\n } .\n OPTIONAL { ?uri rdfs:label ?label } .\n}\n}\norder by ?schema ?uri","type":"text"}]},{"type":"paragraph","content":[{"text":"This, of course, doesn’t mean that we have objects that are instances of all of these types, merely that they are defined in the vocabularies that we have loaded into our data.","type":"text"}]},{"type":"paragraph","content":[{"text":"This means that a sparql query can pull back titles for attributes. Consider:","type":"text"}]},{"type":"codeBlock","content":[{"text":"prefix rdfs: \nprefix dc: \nprefix dcterms: \nprefix g: \n\nselect\n if(?property_name, ?property_name,\n if(?property_label, ?property_label, ?property))\n ?value\nwhere {\n graph g:NSL_APNI {\n ?property ?value .\n }\n graph g:ibis_voc {\n OPTIONAL {\n ?property rdfs:label ?property_label\n }\n OPTIONAL {\n ?property dcterms:title ?property_name\n }\n }\n}\norder by ?property","type":"text"}]},{"type":"paragraph","content":[{"text":"We get a list of labels values for all properties of the name. We could go further and find for each value that is an RDF resource the label of the type of the value, and so on.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Outdated APNI, AFD, and CoL data","type":"text"}]},{"type":"paragraph","content":[{"text":"Our data set contains a static data extract from the Australian Faunal Directory, the Australian Plant Names Index, and data pulled from the Catalogue of Life 2011 CD-ROM. This data is very out-of-date and will probably not be being updated again (althoug a frech extract of AFD may still be possible).","type":"text"}]},{"type":"paragraph","content":[{"text":"APNI is being superseded by NSL, and AFD will also become available as an NSL-structured data set.","type":"text"}]},{"type":"paragraph","content":[{"text":"The old data is presented as far as possible using TDWG terms (classes and predicates) with various additions from local vocabularies where the TDWG ontology did not have terms matching closely enough to the meaning of fields in our data. This document will not attempt to describe the stucture and meaning of this deprecated data.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"g:afd","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"g:apni","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"g:col","type":"text","marks":[{"type":"code"}]},{"text":" graphs are a union of the component parts of the AFD, APNI, and CoL datasets and are probably the most useful way to run queries against that data.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"NSL data","type":"text"}]},{"type":"paragraph","content":[{"text":"The nsl datasets: ","type":"text"},{"text":"g:NSL_APNI","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"g:NSL_OZMOSS","type":"text","marks":[{"type":"code"}]},{"text":" are live links to the underlying NSL tables, provided by way of the ","type":"text"},{"text":"d2rq","type":"text","marks":[{"type":"link","attrs":{"href":"http://d2rq.org/"}}]},{"text":" JENA library. The ","type":"text"},{"text":"g:nsl","type":"text","marks":[{"type":"code"}]},{"text":" graph is a union of these two graphs and the NSL vocbulary. These graphs present live data as RDF triples, queryable by SPARQL. To make sense of the triples available in these graphs, some understanding of the nsl data model is required.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.11.3. The NSL data model and its RDF representation","type":"text"}]},{"type":"paragraph","content":[{"text":"TODO: this will probably need some images and diagrams","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.12. Export","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.12.1. Exports","type":"text"}]},{"type":"paragraph","content":[{"text":"There will be a number of specific exports available via the NSL. These exports are available via the export index found at ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://biodiversity.org.au/nsl/services/api/export/index"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Names export","type":"text"}]},{"type":"paragraph","content":[{"text":"The names export contains all the names currently contained in the shard.","type":"text"}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"example APNI name output","type":"text"}]},{"type":"codeBlock","content":[{"text":"nomenclaturalCode,datasetName,nameType,taxonomicStatus,scientificNameID,scientificName,nomenclaturalStatus,canonicalName,scientificNameAuthorship,ccLicense,ccAttributionIRI,cultivarEpithet,canonicalNameHTML,scientificNameHTML,autonym,hybrid,cultivar,formula,scientific,nomInval,nomIlleg,namePublishedIn,namePublishedInYear,nameInstanceType,originalNameUsage,originalNameUsageID,typeCitation,taxonRank,taxonRankSortOrder,taxonRankAbbreviation,kingdom,class,subclass,family,genericName,specificEpithet,infraspecificEpithet,created,modified,nameElement,firstHybridParentName,firstHybridParentNameID,secondHybridParentName,secondHybridParentNameID\nICNAFP,APNI,scientific,ApcConcept,http://id.biodiversity.org.au/name/apni/54717,Plantae Haeckel,,Plantae,Haeckel,http://creativecommons.org/licenses/by/3.0/,http://id.biodiversity.org.au/name/apni/54717,,Plantae,\"Plantae Haeckel\",f,f,f,f,t,f,f,\"Haeckel, E. (1866), Generelle Morphologie der Organisen 2\",1866,tax. nov.,,http://id.biodiversity.org.au/instance/apni/738438,,Regnum,10,reg.,Plantae,,,,,,,2012-02-10 16:26:54+11,2012-02-10 16:26:54+11,Plantae,,,,\nICNAFP,APNI,scientific,ApcConcept,http://id.biodiversity.org.au/name/apni/80157,Tapeinochilos Miq.,nom. cons.,Tapeinochilos,Miq.,http://creativecommons.org/licenses/by/3.0/,http://id.biodiversity.org.au/name/apni/80157,,Tapeinochilos,\"Tapeinochilos Miq.\",f,f,f,f,t,f,f,\"Miquel, F.A.W. (1869), Observationes de Zingiberaceis. Annales Musei Botanici Lugduno-Batavi 4\",1869,tax. nov.,,http://id.biodiversity.org.au/instance/apni/495884,,Genus,120,gen.,,,,,Tapeinochilos,,,2009-10-08 10:20:23+11,2009-10-08 10:20:23+11,Tapeinochilos,,,,\nICNAFP,APNI,scientific,taxonomic synonym,http://id.biodiversity.org.au/name/apni/202753,Hieracium praealtum Vill. ex Gochnat,,Hieracium praealtum,Vill. ex Gochnat,http://creativecommons.org/licenses/by/3.0/,http://id.biodiversity.org.au/name/apni/202753,,Hieracium praealtum,\"Hieracium praealtum Vill. ex Gochnat\",f,f,f,f,t,f,f,\"Gochnat, F.C. (1808), Tentamen medico-botanicum de plantis cichoraceis\",1808,tax. nov.,,http://id.biodiversity.org.au/instance/apni/722911,,Species,190,sp.,,,,,,,,2006-09-20 16:58:13+10,2011-11-01 17:28:31+11,praealtum,,,,","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Taxon export","type":"text"}]},{"type":"paragraph","content":[{"text":"The taxon export contains a list of Accepted names for the chosen classification.","type":"text"}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"example APC taxon output","type":"text"}]},{"type":"codeBlock","content":[{"text":"nomenclaturalCode,taxonID,nameType,scientificNameID,scientificName,nomenclaturalStatus,taxonomicStatus,proParte,acceptedNameUsage,acceptedNameUsageID,parentNameUsageID,taxonRank,taxonRankSortOrder,kingdom,class,subclass,family,created,modified,datasetName,taxonConceptID,nameAccordingToID,nameAccordingTo,taxonRemarks,taxonDistribution,higherClassification,ccLicense,ccAttributionIRI ,canonicalName,scientificNameAuthorship,firstHybridParentName,firstHybridParentNameID,secondHybridParentName,secondHybridParentNameID\nICNAFP,http://id.biodiversity.org.au/instance/apni/885443,scientific,http://id.biodiversity.org.au/name/apni/223346,Proteae Juss.,orth. var.,orthographic variant,f,Proteaceae Juss.,http://id.biodiversity.org.au/node/apni/6766982,,Familia,80,Plantae,Equisetopsida,Magnoliidae,Proteaceae,2009-11-06 10:18:27+11,2010-12-01 11:56:19+11,{APNI},http://id.biodiversity.org.au/instance/apni/651623,http://id.biodiversity.org.au/reference/apni/23746,\"Jussieu, A.L. de (1789), Genera Plantarum\",,\"WA (native and naturalised), NT, SA (native and naturalised), Qld (native and naturalised), NSW (native and naturalised), LHI (naturalised), NI (naturalised), ACT (native and naturalised), Vic (native and naturalised), Tas (native and naturalised)\",,http://creativecommons.org/licenses/by/3.0/,http://id.biodiversity.org.au/instance/apni/885443,Proteae,Juss.,,,,\nICNAFP,http://id.biodiversity.org.au/node/apni/6766982,scientific,http://id.biodiversity.org.au/name/apni/54427,Proteaceae Juss.,nom. cons.,ApcConcept,f,,http://id.biodiversity.org.au/node/apni/6766982,http://id.biodiversity.org.au/node/apni/6766983,Familia,80,Plantae,Equisetopsida,Magnoliidae,Proteaceae,1996-05-31 04:06:38+10,2008-10-27 16:33:55+11,\"{APC,APNI}\",http://id.biodiversity.org.au/instance/apni/650643,http://id.biodiversity.org.au/reference/apni/46762,\"CHAH (2008), Australian Plant Census\",,\"WA (native and naturalised), NT, SA (native and naturalised), Qld (native and naturalised), NSW (native and naturalised), LHI (naturalised), NI (naturalised), ACT (native and naturalised), Vic (native and naturalised), Tas (native and naturalised)\",Plantae.Charophyta.Equisetopsida.Magnoliidae.Proteanae.Proteales.Proteaceae,http://creativecommons.org/licenses/by/3.0/,http://id.biodiversity.org.au/node/apni/6766982,Proteaceae,Juss.,,,,\nICNAFP,http://id.biodiversity.org.au/instance/apni/884406,scientific,http://id.biodiversity.org.au/name/apni/54707,Sterculiaceae Vent.,nom. cons.,taxonomic synonym,f,Malvaceae Juss.,http://id.biodiversity.org.au/node/apni/6770312,,Familia,80,Plantae,Equisetopsida,Magnoliidae,Malvaceae,1996-05-23 21:49:45+10,2011-10-20 15:20:06+11,{APNI},http://id.biodiversity.org.au/instance/apni/632242,http://id.biodiversity.org.au/reference/apni/46889,\"Ventenat, E.P. in Salisbury, R.A. (1807), Paradisus Londinensis 2\",\"Bombacaceae is recognised as distinct in Qld, represented by Bombax, Campostemon and Lagunaria. Brownlowiaceae is recognised as distinct in Qld, represented by Berrya, Brownlowia and Indagator. Byttneriaceae is recognised as distinct in Qld, represented by Abroma, Commersonia, Dicarpidium, Hannafordia, Keraudrenia, Kleinhovea, Lasiopetalum, Melochia, Rulingia, Seringia and Waltheria. Helicteraceae is recognised as distinct in Qld, represented by Helicteres. Pentapetaceae is recognised as distinct in Qld, represented by Melhania. Sterculiaceae is recognised as distinct in Qld, represented by Argyrodendron, Brachychiton, Firmania, Franciscodendron, Heritiera and Sterculia.\",\"WA (native and naturalised), CoI, ChI (native and naturalised), AR, NT (native and naturalised), SA (native and naturalised), Qld (native and naturalised), CSI, NSW (native and naturalised), LHI (native and naturalised), NI (native and naturalised), ACT (native and naturalised), Vic (native and naturalised), Tas (native and naturalised)\",,http://creativecommons.org/licenses/by/3.0/,http://id.biodiversity.org.au/instance/apni/884406,Sterculiaceae,Vent.,,,,\nICNAFP,http://id.biodiversity.org.au/instance/apni/884407,scientific,http://id.biodiversity.org.au/name/apni/54675,Tiliaceae Juss.,nom. cons.,taxonomic synonym,f,Malvaceae Juss.,http://id.biodiversity.org.au/node/apni/6770312,,Familia,80,Plantae,Equisetopsida,Magnoliidae,Malvaceae,1996-05-23 21:49:57+10,2011-10-20 13:07:32+11,{APNI},http://id.biodiversity.org.au/instance/apni/632243,http://id.biodiversity.org.au/reference/apni/23746,\"Jussieu, A.L. de (1789), Genera Plantarum\",\"Bombacaceae is recognised as distinct in Qld, represented by Bombax, Campostemon and Lagunaria. Brownlowiaceae is recognised as distinct in Qld, represented by Berrya, Brownlowia and Indagator. Byttneriaceae is recognised as distinct in Qld, represented by Abroma, Commersonia, Dicarpidium, Hannafordia, Keraudrenia, Kleinhovea, Lasiopetalum, Melochia, Rulingia, Seringia and Waltheria. Helicteraceae is recognised as distinct in Qld, represented by Helicteres. Pentapetaceae is recognised as distinct in Qld, represented by Melhania. Sterculiaceae is recognised as distinct in Qld, represented by Argyrodendron, Brachychiton, Firmania, Franciscodendron, Heritiera and Sterculia.\",\"WA (native and naturalised), CoI, ChI (native and naturalised), AR, NT (native and naturalised), SA (native and naturalised), Qld (native and naturalised), CSI, NSW (native and naturalised), LHI (native and naturalised), NI (native and naturalised), ACT (native and naturalised), Vic (native and naturalised), Tas (native and naturalised)\",,http://creativecommons.org/licenses/by/3.0/,http://id.biodiversity.org.au/instance/apni/884407,Tiliaceae,Juss.,,,,","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Notes","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nodes start in a draft state that permits edits","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"That is: the content does not change. The state obviously does, but only in respect of the internal functioning of the tree, not in terms of the node’s nomenclatural or taxonomic meaning or status.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"timestamps are often problematic, Common problems involving confusions about timezone and system clocks not properly set.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http://www.biodiversity.org.au/voc/boa/Tree#END-NODE","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://www.biodiversity.org.au/voc/boa/Tree#END-NODE"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http://www.biodiversity.org.au/voc/boa/Tree#END-TREE","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://www.biodiversity.org.au/voc/boa/Tree#END-TREE"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It doesn’t make sense to say that 1 has changed into 2. It only makes sense to say that something has a property that has changed from 1 to 2. That is: you are talking about the link, which belongs to the supernode, not about the value node itself.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It might be reasonable for profile data to be linked to with tracking links, depending on how it is managed. Such a link would be more of an FYI inclusion - it would mean that the content of the document does not form part of the identity of the taxon","type":"text","marks":[{"type":"em"}]}]}]}]}],"version":1}