Passo 3 (de 5)
3. Escreva para um ORCID registro (POST)
Parabéns! Você configurou tudo e está coletando IDs e permissões – agora é a parte divertida! Nesta lição, você aprenderá como gravar dados em um ORCID registro.
Nesta seção, adicionaremos uma afiliação 'educacional' ao seu registro do Sandbox.
No exemplo a seguir, estamos usando o endpoint /education com o XML correto para adicionar as informações, mas você também pode adicionar Emprego ou Trabalhos, por exemplo. Veja nosso Documentação do Github para obter mais exemplos de arquivos e endpoints e as permissões necessárias para cada um.
Aqui está um exemplo de XML de educação que você pode usar para este exercício:
<?xml version="1.0" encoding="UTF-8"?>
<education:education
xmlns:common="http://www.orcid.org/ns/common" xmlns:education="http://www.orcid.org/ns/education"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.orcid.org/ns/education ../education-3.0.xsd ">
<common:department-name>department-name</common:department-name>
<common:role-title>role-title</common:role-title>
<common:start-date>
<common:year>1948</common:year>
<common:month>02</common:month>
<common:day>02</common:day>
</common:start-date>
<common:end-date>
<common:year>1948</common:year>
<common:month>02</common:month>
<common:day>02</common:day>
</common:end-date>
<common:organization>
<common:name>common:name</common:name>
<common:address>
<common:city>common:city</common:city>
<common:region>common:region</common:region>
<common:country>AF</common:country>
</common:address>
<common:disambiguated-organization>
<common:disambiguated-organization-identifier>http://dx.doi.org/10.13039/100000001</common:disambiguated-organization-identifier>
<common:disambiguation-source>FUNDREF</common:disambiguation-source>
</common:disambiguated-organization>
</common:organization>
<common:url>http://tempuri.org</common:url>
<common:external-ids>
<common:external-id>
<common:external-id-type>grant_number</common:external-id-type>
<common:external-id-value>external-identifier-value</common:external-id-value>
<common:external-id-url>http://tempuri.org</common:external-id-url>
<common:external-id-relationship>self</common:external-id-relationship>
</common:external-id>
<common:external-id>
<common:external-id-type>grant_number</common:external-id-type>
<common:external-id-value>external-identifier-value2</common:external-id-value>
<common:external-id-url>http://tempuri.org/2</common:external-id-url>
<common:external-id-relationship>self</common:external-id-relationship>
</common:external-id>
</common:external-ids>
</education:education>
Retorne à guia do navegador do Google Developers OAuth 2.0 Playground. Se você não manteve a aba aberta, você pode reinicializar a sessão com a URL que você salvou anteriormente (clicando em OK no aviso que aparece). Ou você pode configurar a chamada novamente preenchendo todos os campos relevantes, certificando-se de que eles se pareçam com as capturas de tela abaixo:
Verifique se o • Configuração tem o seu ID do cliente e segredo do cliente
Abaixo da Etapa 2 no playground do google oauth, você deve ter seu token de acesso preenchido
Ele ainda deve ter o token de antes ou você pode preenchê-lo do exercício anterior assim:
Abaixo da Etapa 3 no playground OAuth 2 do Google Developers, clique Adicionar cabeçalhos, insira os valores abaixo e clique em Adicionar e Fechar
Header name: Accept
Header value: application/vnd.orcid+xml
Abaixo da Etapa 3: Configurar solicitar para APIconjunto Método HTTP para PUBLICAR.
Na Solicitar URI campo digite:
https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education
Substituir [ORCID ID] com o iD para seu registro Sandbox, formate XXXX-XXXX-XXXX-XXXX com o qual você obteve permissão para interagir.
Clique Tipo de conteúdo > Personalizadas e entre
application/vnd.orcid+xml
Clique Adicionar, então clique Fechar.
Clique Digite o corpo da solicitação.
Copie o XML de afiliação educacional na parte superior desta seção e cole-o no Corpo da solicitação caixa de texto:
OPCIONAL: Na Corpo da solicitação caixa de texto, edite o XML para refletir sua instituição. Por , use o Registro ROR para encontrar o ROR ID da sua instituiçãon.
Clique Fechar.
Clique Envie o pedido.
Os resultados aparecerão no Pedido / Resposta seção à direita. Role até o final da resposta - se você vir HTTP/1.1 201 Criado, sua afiliação educacional foi adicionada com sucesso! Abaixo você pode ver um trecho de um exemplo de como o XML aparecerá com a mensagem 201 criada na parte inferior.
... <common: month>01</common: month> <common: day>01</common: day>
</ common: start-date> <education:organization>
<common: name>My University</common: name> <common: address>
<common: city>Some City</common:city> <common: region>Region</common: region> <common: country>US</common:country>
</ common: address>
HTTP/1.1 201 Created
Content length. A X-xss-protection: 1; mode=block X-content-type-options: nosniff
Expires: 0
Server: nginx/1.10.0
Connection: keep-alive
Location: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Pragma: no-cache
Cache-control: no-cache, no-store, max-age=0, must-revalidate
Date: Thu, 15 Jun 2017 20:44:09 GMT
Access-control-allow-origin: *
Content-type: application/vnd.orcid+xml: qs=5;charset=UTF-8
X-frame-options: DENY
Por favor, salve seu código de inserção, ele será necessário na próxima seção para atualizar os itens!
Salve seu código de inserção
Os códigos de venda são códigos numéricos curtos que fazem referência a um item específico no ORCID registro.
Quando você publica um item no registro de um pesquisador, a resposta da API conterá o código put desse item. Você pode armazenar o código de venda para usá-lo mais tarde se precisar ler, atualizar ou excluir esse item.
No exemplo acima, o código de entrada são os 5 dígitos no final desta linha: Location: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Se houver um erro em sua resposta, verifique se não há erros de digitação em suas tags XML e se você digitou todos os outros detalhes corretamente. O menor erro de digitação pode quebrar tudo!
Visite a visualização pública do seu registro Sandbox em https://sandbox.orcid.org/[ORCID ID] para ver sua nova afiliação educacional.
Observe que Source mostra o nome do cliente da API que adicionou a afiliação – este é um elemento chave que ajuda outros sistemas a consumir ORCID os dados determinam se essa informação tem autoridade.