Come aggiungo un elemento usando il ORCID API?

Gli elementi (lavori, occupazione, finanziamenti, revisione paritaria, ecc.) possono essere aggiunti a un ORCID registrare utilizzando il ORCID API membro. Per fare questo, devi prima ottenere il permesso dal ricercatore utilizzando OAuth e di formattare i metadati dell'elemento usando il ORCID schema del messaggio.

Dopo aver formattato i dati e raccolto il file ORCID iD e token di accesso, si effettua una richiesta API utilizzando HTTP POST, specificando il endpoint rilevante.

Method: POST 
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]data: link to file or text of single employment item to add 
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment

La chiamata qui sotto aggiunge una nuova occupazione affiliazione a un record sul server di test sandbox:

<?xml version="1.0" encoding="UTF-8"?>      
<employment:employment [...]>     
[...]            
</employment:employment>

Esempio di chiamata: Github

L'API restituirà un messaggio 201 per indicare che l'articolo è stato pubblicato correttamente, insieme all'articolo metti il ​​codice. Il tuo cliente sarà elencato come il fonte dell'articolo.

Vai alla la risoluzione dei problemi pagina se viene restituito un messaggio diverso. Dovrai salvare il  memorizzare il codice put e il token di accesso per apportare eventuali aggiornamenti o rimuovere l'elemento.