{"_id":"568e6c9dd74a0d0d00905ec9","parentDoc":null,"__v":23,"category":{"_id":"5614ef94a4ccab0d00e698b5","project":"5613d8fc6a092921004c30b9","version":"5613d8fc6a092921004c30bc","__v":15,"pages":["5614effea4ccab0d00e698b7","5614f0564c7b1c0d00fc3026","5614f07adc11550d00045672","5614f08ef8f2890d006d9f69","5614f09fbeee6f0d009df1a5","5624cadd5a86b423009462c0","5624cc235a86b423009462c6","5630ad2fc3a8150d00fb793a","5630cabfeae7ef0d00270dae","56379bacdf54e41900d3a0aa","568e6c9dd74a0d0d00905ec9","568f8ab5beb2700d00471892","568f953394c5030d00288087","568fe2ce4719c119002ce60b","569667d6b6d61f0d00acfae8"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-07T10:10:28.718Z","from_sync":false,"order":3,"slug":"integrators","title":"Integrators"},"version":{"_id":"5613d8fc6a092921004c30bc","__v":10,"project":"5613d8fc6a092921004c30b9","createdAt":"2015-10-06T14:21:48.908Z","releaseDate":"2015-10-06T14:21:48.908Z","categories":["5613d8fd6a092921004c30bd","5614ef94a4ccab0d00e698b5","5614ef9abeee6f0d009df1a2","5614efb2a4ccab0d00e698b6","5624cb406ff1010d009b1611","5624ce8772ac510d00e4918b","5624e1195a86b423009462ec","568e68490844350d002ffa47","568e6b010844350d002ffa4a","568e6b65d892e80d00a5d37a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"project":"5613d8fc6a092921004c30b9","user":"5613d895443514170060dba9","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-07T13:48:13.572Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"The information you need to start integrating persistent identifiers [PIDs](doc:introduction-to-persistent-identifiers) depends on your use cases.  Some services will be concerned with creating  [DOIs](doc:what-is-a-doi)  while others simply need to query the metadata.  Likewise, some systems may require authenticated [ORCID IDs](doc:explaining-orcid) to aid interoperability, others will want to retrieve metadata or update records.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Integrating DOIs\"\n}\n[/block]\n## Querying DOI metadata\n\nQuerying DOI metadata is as simple as making a request to the DOI URL using content negotiation.  See [Accessing DOI metadata](doc:accessing-doi-metadata) for more details.\n\n## Searching DOI registries\n\nSearching DOI registries is complicated by the fact there is more than one of them.  Each offers its own search API.  [Searching DOI registries](doc:searching-doi-registries) contains more information.\n\n## Creating DOI metadata\n\nCreating DOI metadata is a bit more complex.  You need to work with a DOI registration agency, become a member, create XML in the correct format and submit it.  Workflows vary between registrars.  [Creating DOIs and DOI metadata.](doc:creating-dois-and-doi-metadata) explains this in more detail.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Integrating ORCID\"\n}\n[/block]\nORCID has a [Public API](doc:orcid-public-api-tutorial) and a [Member API](doc:orcid-member-api-tutorial).  At a high level, the public API is read only and the member API allows updates.  With the user's permission, the member API also enables you to query data users have marked as 'limited access' and set up notifications.\n\nThere are other differences so make sure you understand the difference and choose the right one for your use case.\n\n## Querying ORCID metadata\n\nThe ORCID API enables client applications to retrieve biographical information about a researcher and their works, peer review activities, education and employment.  The [ORCID Public API](doc:orcid-public-api-tutorial) section contains a couple of examples and further information.\n\n## Updating ORCID records\nUpdating records requires the [ORCID Member API](doc:orcid-member-api-tutorial).  With the members permission, you can add and update an ORCID record.\n\n## Authenticating ORCID users\n\nORCID uses OAuth to authenticate users and authorise actions with the API.  The two-step (application) flow is used to access public data or authenticate a user.  Actions that require user authorisation use the three-legged approach.  See the [ORCID API - Authenticating users](doc:orcid-api-authenticating-users) section for more details.\n\n## Searching the ORCID registry\n\nORCID exposes a SOLR endpoint for machine to machine searching.  [Searching ORCID](doc:searching-orcid) explains how this works with examples.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"External information\"\n}\n[/block]\nThere is a great [integration presentation on the ORCID website](https://orcid.org/organizations/integrators) that walks through the integration process.  There is also [extensive ORCID API documentation](http://members.orcid.org./api)\n\nThere is an excellent [help system at Crossref](http://help.crossref.org/) and [API documentation at Datacite](https://mds.datacite.org/static/apidoc)\n\nCrosscite.org contains detailed information about using content negotiation to [resolve DOIs into metadata](http://www.crosscite.org/cn/).","excerpt":"","slug":"introduction-for-integrators","type":"basic","title":"Introduction for integrators"}

Introduction for integrators


The information you need to start integrating persistent identifiers [PIDs](doc:introduction-to-persistent-identifiers) depends on your use cases. Some services will be concerned with creating [DOIs](doc:what-is-a-doi) while others simply need to query the metadata. Likewise, some systems may require authenticated [ORCID IDs](doc:explaining-orcid) to aid interoperability, others will want to retrieve metadata or update records. [block:api-header] { "type": "basic", "title": "Integrating DOIs" } [/block] ## Querying DOI metadata Querying DOI metadata is as simple as making a request to the DOI URL using content negotiation. See [Accessing DOI metadata](doc:accessing-doi-metadata) for more details. ## Searching DOI registries Searching DOI registries is complicated by the fact there is more than one of them. Each offers its own search API. [Searching DOI registries](doc:searching-doi-registries) contains more information. ## Creating DOI metadata Creating DOI metadata is a bit more complex. You need to work with a DOI registration agency, become a member, create XML in the correct format and submit it. Workflows vary between registrars. [Creating DOIs and DOI metadata.](doc:creating-dois-and-doi-metadata) explains this in more detail. [block:api-header] { "type": "basic", "title": "Integrating ORCID" } [/block] ORCID has a [Public API](doc:orcid-public-api-tutorial) and a [Member API](doc:orcid-member-api-tutorial). At a high level, the public API is read only and the member API allows updates. With the user's permission, the member API also enables you to query data users have marked as 'limited access' and set up notifications. There are other differences so make sure you understand the difference and choose the right one for your use case. ## Querying ORCID metadata The ORCID API enables client applications to retrieve biographical information about a researcher and their works, peer review activities, education and employment. The [ORCID Public API](doc:orcid-public-api-tutorial) section contains a couple of examples and further information. ## Updating ORCID records Updating records requires the [ORCID Member API](doc:orcid-member-api-tutorial). With the members permission, you can add and update an ORCID record. ## Authenticating ORCID users ORCID uses OAuth to authenticate users and authorise actions with the API. The two-step (application) flow is used to access public data or authenticate a user. Actions that require user authorisation use the three-legged approach. See the [ORCID API - Authenticating users](doc:orcid-api-authenticating-users) section for more details. ## Searching the ORCID registry ORCID exposes a SOLR endpoint for machine to machine searching. [Searching ORCID](doc:searching-orcid) explains how this works with examples. [block:api-header] { "type": "basic", "title": "External information" } [/block] There is a great [integration presentation on the ORCID website](https://orcid.org/organizations/integrators) that walks through the integration process. There is also [extensive ORCID API documentation](http://members.orcid.org./api) There is an excellent [help system at Crossref](http://help.crossref.org/) and [API documentation at Datacite](https://mds.datacite.org/static/apidoc) Crosscite.org contains detailed information about using content negotiation to [resolve DOIs into metadata](http://www.crosscite.org/cn/).