Julho marca o quinto mês desde que lançamos ORCID API v2.0, e temos o prazer de informar que muitos usuários da API Pública e de Membros já atualizaram ou estão em processo de atualização. Para encorajar aqueles de vocês que ainda não começaram sua atualização, gostaríamos de destacar alguns dos recursos da v2.0 que irá simplificar seus fluxos de trabalho, reduzir o tamanho dos arquivos de transferência e tornar o seu ORCID a integração funciona melhor para você e seus usuários.
Menos osciloscópios, menos confusão
Nossa API antiga permitia que você solicitasse muitos permissões de usuários: permissão para criar itens em uma seção, para ler a mesma seção e atualizá-la. Solicitar permissões separadas para cada seção resultou em uma lista de solicitações que confundiu os usuários.
Na API v2.0, nós consolidou nossos escopos em três, que permitem que você solicite acesso de leitura (limitado) e atualização a todas as seções do ORCID registro.
Ainda tem esses tokens nas permissões mais antigas? Não se preocupe - eles continuarão a funcionar nos níveis de acesso para os quais foram originalmente emitidos. Mas você pode querer construir um fluxo de trabalho para solicitar que os usuários atualizem suas permissões se o seu sistema atualizado tiver novos recursos envolvendo acesso a outras seções de seus registros.
Leia e atualize por item
Usando versões anteriores da API, se seu sistema precisava adicionar um novo trabalho único em um registro ao qual você adicionou vários trabalhos, então ele teve que atualizar toda a seção de trabalhos, incluindo o novo trabalho e todos os trabalhos adicionados anteriormente. Como resultado, atualizar um único item em um registro envolvia o envio de um arquivo potencialmente grande de outros itens que não tinham alterações, ou a perda de todos os itens daquela seção, ou mesmo de todo o registro.
v2.0 simplificou este processo por gerenciamento de itens em uma base individual. Seu sistema pode adicionar uma única obra a um ORCID registroe, em seguida, edite ou exclua esse único trabalho. Isso é feito implementando colocar códigos para itens individuais no ORCID Registro. Por exemplo, se o seu sistema adiciona uma nova afiliação de emprego a um ORCID registro, o ORCID A API retorna uma mensagem de confirmação junto com o código de inserção que seu sistema pode usar para atualizar ou excluir apenas aquele item. Em geral, apenas um item pode ser adicionado, editado ou excluído por vez em um ORCID registro. A única exceção são as obras, que para muitos pesquisadores constituem a maior parte de seus ORCID registro. API v2.0 permite que seus sistemas leia até 50 obras de cada vez, e para adicione até 100 trabalhos de uma vez. A edição ou exclusão de trabalhos ainda deve ser feita por item.
Os códigos de colocação são retroativos: os itens adicionados em 1.2 e anteriores foram atribuídos a códigos de colocação. Conforme você trabalha para atualizar seu sistema para a v2.0, lembre-se de adicionar um campo para seu código de inserção correspondente. Você pode consultar um ORCID registro para obter os códigos de inserção de quaisquer itens que seu sistema tenha adicionado ao Registro e atualize seu banco de dados de acordo para que possa atualizá-los no futuro, conforme necessário.
Leia os registros mais rápido
API v2.0, como a API anterior, permite que seu sistema leia uma única seção ou o registro inteiro em uma única chamada. O que retorna não serão todos os dados em um registro, mas sim uma visão resumida das três seções que tendem a ser as maiores em ORCID registros: obras, financiamento e revisões por pares.
Quer o seu sistema leia o registro completo ou uma única seção, o visão resumida dessas atividades é exibido. O resumo contém informações limitadas: o resumo da obra, por exemplo, retorna apenas o título da obra, tipo, data, seus identificadores únicos e sua relação com a obra, o índice de exibição para cada versão do item (se houver várias versões), a fonte (o usuário ou cliente API) e o código de inserção correspondente para cada versão do item.
As visualizações resumidas reduzem o tamanho dos arquivos e os tempos de transferência, reduzindo a tensão potencial em nosso sistema e no seu, e agilizando as atualizações.
E muito mais!
Há muito mais coisas na v2.0 para ficar feliz: suporte flexível para identificadores externos, adição de atividades de revisão por pares, agrupamento mais claro de várias versões de atividades, melhores resultados de pesquisa por padrão e muito mais.
Quer saber mais? Junte-se a nós! Todos os meses, realizamos webinars em vários fusos horários e idiomas e, no resto do ano, discutiremos a atualização para a API v2.0. Verifique nossas listas para o próximoou Contacte-nos para saber mais.
Você já atualizou para a API v2.0? Deixe-nos saber a sua experiência!