Como uma organização de pesquisa, você está em uma posição única para conectar informações validadas e confiáveis sobre seus pesquisadores e sua afiliação com seus ORCID registros. Isso permite que você controle como seu nome é usado na literatura de pesquisa e permite que você acompanhe facilmente ex-funcionários, alunos e professores. Ele torna simples para seus pesquisadores compartilharem informações precisas e confiáveis sobre sua afiliação com sua instituição ao se candidatar a bolsas, publicar um artigo, livro ou banco de dados e muito mais.
Esses fluxos de trabalho são aplicáveis à gestão de alunos, matrículas, recursos humanos e sistemas de perfis.
Fluxo de Trabalho 1: Coletando IDs em seus sistemas
- Ao registrar seus dados por meio de um formulário da web, os registrantes são solicitados a autenticar seus ORCID iD e conceder permissão à sua organização para interagir com seu registro.
- Assim que seu registro for aprovado, seu sistema atualiza a seção apropriada do ORCID registro com detalhes de sua posição ou distinção, conectando-os com sua organização.
- Exibir seus autenticados ORCID iD ao lado de qualquer informação publicamente disponível sobre eles.
Fluxo de Trabalho 2: Coletando IDs retrospectivamente
Se seu sistema já contém informações sobre seus pesquisadores e suas atividades anteriores, ou se não há nenhum componente de registro, você pode:
- Envie um e-mail aos indivíduos com um link exclusivo que eles podem usar para se conectarem ao seu sistema.
- Quando clicado, este link direciona o indivíduo para ORCID para autenticar seu iD e conceder permissão à sua organização para atualizar o registro.
- Em seguida, você os redireciona para uma página da web criada especialmente por você.
- Seu sistema armazena o link entre o ORCID iD e endereço de e-mail / conta de usuário, e usa as permissões que o indivíduo concedeu para atualizar a seção apropriada de seu ORCID registrar, conectando-os e suas atividades com a sua organização.
- Exibir seus autenticados ORCID iD ao lado de qualquer informação publicamente disponível sobre eles.
As afirmações de afiliação contêm datas de início e término e recomendamos enfaticamente que você preencha esses campos sempre que possível, pois isso facilita a verificação da afiliação do pesquisador à sua organização. Os fluxos de trabalho acima permitem permissões de atualização de longo prazo, que podem ser usadas para atualizar a data de término quando a afiliação de um indivíduo termina. Seu sistema deve usar o ORCID API para adicionar uma data de término (quando aplicável), a fim de tornar claro o termo completo da afiliação.
Exemplo
Benefícios
Você pode ajudar seus pesquisadores a obter crédito, conectando informações validadas sobre sua afiliação com você para seus ORCID registros. Ao mesmo tempo, você estará ajudando a construir confiança nas comunicações acadêmicas. Ao afirmar a conexão entre indivíduos e sua organização - conexões que apenas sua organização pode fazer com autoridade - você garante que sua organização seja devidamente reconhecida quando seus funcionários e afiliados fizerem contribuições profissionais. Essas informações podem então ser compartilhadas, com a permissão do pesquisador, com os outros sistemas com os quais eles interagem, ajudando a criar uma infraestrutura de informações de pesquisa confiável.
Como resultado de nossas discussões com editores, fornecedores e pesquisadores, desenvolvemos uma abordagem inicial resumo do registro protótipo. Esperamos tornar mais fácil para os editores encontrar e compreender as informações dentro ORCID registra e traz à tona o marcadores de confiança que pode ajudá-lo a tomar decisões sobre a confiabilidade de um ORCID registro.
Quais informações são exibidas no resumo?
Dependendo de quais dados públicos estão disponíveis no arquivo do autor ORCID registro dependerá de quais informações serão exibidas. Abaixo está a lista de itens que podem ser exibidos:
- Nome ou nome publicado/crédito – Se o registro tiver um nome publicado, isso será exibido, mas se não, o nome será exibido
- ORCID iD
- Afiliações – Esta seção exibe apenas itens de emprego. Nome da organização com um link para o URL de afiliação (se incluído), Função, datas (se incluído). Eles são exibidos em ordem cronológica do mais recente para o mais antigo. 3 afiliações são mostradas, se aplicável, com uma contagem adicional de outras afiliações no registro.
- Obras – uma contagem de obras validadas e obras autoafirmadas
- Revisão por pares – uma contagem de itens de revisão por pares validados. Observe que isso mostrará apenas uma contagem de itens validados, pois os usuários não podem adicionar manualmente a revisão por pares aos seus registros
- Financiamento – uma contagem de financiamento validado e financiamento autodeclarado
- Atividades profissionais – esta seção exibe os 3 itens mais recentes de Afiliação, Serviço, Cargos Convidados e Distinção. Eles são exibidos em ordem cronológica, do mais recente ao mais antigo.
- Outros identificadores – Esta seção exibe os outros identificadores que foram conectados ao usuário ORCID eu ia. Por exemplo, Scopus Author ID, ISNI ou ResearcherID
- Datas-chave – As datas incluem a data em que o registro foi criado e a data em que o registro foi atualizado pela última vez
Qual é a diferença entre os itens validados e os autoafirmados?
O ícone de origem exibido ao lado dos diferentes itens mostra se o item foi adicionado ao registro dos autores por um confiável ORCID organização membro ou pelo próprio autor
- Validado – Adicionado por um confiável ORCID organização membro
- Autoafirmado – Adicionado diretamente pelo autor
Por que não há informações exibidas além das datas importantes?
O controle individual é um princípio fundamental do ORCID Programa de confiança. ORCID os detentores de registros controlam quais informações são adicionadas e excluídas de seus ORCID registro, com controle refinado sobre a visibilidade das informações e controle sobre quais organizações e indivíduos confiáveis podem acessar seus registros para ler, escrever ou atualizar suas informações.
O ORCID iD está sempre disponível publicamente, mas o detentor do registro pode controlar as configurações de visibilidade de todos os outros itens do seu registro. O resumo exibirá apenas itens que tenham a configuração de visibilidade 'Todos', pois são exibidos na versão pública dos usuários de seus ORCID registro.
Por que o registro mostra que está bloqueado, obsoleto ou desativado?
Quando um ORCID registro tiver um dos status acima, então nenhum dado público estará disponível sobre o ORCID registro.
- Bloqueado = o registro não está em conformidade com nossos termos de serviço
- Obsoleto = registro foi descontinuado em outro ORCID iD
- Desativado = registro foi desativado pelo usuário
Navegue nosso Grupo de usuários API tópicos para obter mais informações sobre como configurar uma integração com a API pública. No entanto, para maximizar os benefícios da ORCID, recomendamos você juntar ORCID como membro organizacional, que oferece acesso a funcionalidades adicionais, assistência pessoal de nossa equipe de integração e, claro, ajuda a apoiar nosso trabalho.
As credenciais de Cliente público são concedidas a indivíduos e não a organizações. As credenciais não podem ser transferidas de um indivíduo para outro, mas podem ser convertidas em credenciais de membro da API se o acordo for recebido de todas as partes e a organização for um membro ativo do ORCID.
Mover o ID do cliente para a API do membro não alterará o ID do cliente, apenas o segredo do cliente, e você manterá o número de IDs conectados com sua permissão somente leitura.
Ao converter o cliente de API pública em um cliente de API de membro, o Termos de Serviço do Cliente Público não se aplicam mais e são substituídos pelos termos do Contrato de Membro.
Para a transferência, precisaríamos de:
- Confirmação do ID do cliente da API pública a ser convertido.
- Que o contato principal da organização e o detentor do registro do ID do cliente da API pública atual concordem com a alteração nos Termos de Serviço. (O detentor do registro precisa ser um funcionário, contratado ou executivo da organização membro) Manteremos um registro do consentimento de ambas as partes.
- Uma data/hora para a migração acontecer. Como parte dessa migração, atualizaremos o ID do cliente e enviaremos a você um novo segredo do cliente em um e-mail criptografado. Observe que, depois que atualizarmos o cliente, sua integração não funcionará até que você atualize o segredo do cliente. É por isso que precisamos fixar uma data e hora para que isso seja feito e para evitar inconvenientes para os usuários.
Para que a conversão seja concluída, você precisará atualizar:
- O antigo segredo do cliente para o novo segredo do cliente.
- O host da API de pub.orcid.org para api.orcid.org.
Com seu ID de cliente da API Member convertido, você pode atualizar os escopos para adicionar escopos de API de membros. Isso exigirá autorização dos usuários e novos tokens de acesso serão gerados para incluir os novos escopos/permissões.
Observe que não podemos converter credenciais de clientes da API de membro em credenciais de API pública.
Membros do Consórcio – Uma lista dos membros do seu consórcio com uma contagem de afiliações. A partir desta lista, você pode detalhar o relatório de afiliação de membros individuais para ver os dados de afiliação com mais detalhes. Para fazer drill, selecione o membro na lista, clique com o botão direito, selecione drill e clique no relatório relevante.
IDs de organizações membros de consórcios - Uma lista de IDs de organizações registradas dos membros do consórcio, incluindo o tipo de identificador, valor e nome.
Este exemplo de chamada recupera um resumo do completo ORCID registro em formato XML usando a API membro no servidor sandbox. Você precisa de um token de acesso para fazer solicitações de API para a API Pública ou Membro.
Method: GET
Accept: application/vnd.orcid+xml
Authorization type and Access token: Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
A API retornará uma mensagem 200 OK, indicando que a solicitação foi recebida com sucesso e o resumo completo do ORCID registro, incluindo resumos de itens individuais
<?xml version="1.0" encoding-"UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789"
xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
Cada item (trabalho, financiamento, emprego, etc.) tem um colocar código. Isso pode ser usado para obter detalhes completos do item, se necessário.
Recomendamos que você leia nosso documentação escrita. Se você ainda tem dúvidas e é um ORCID membro, entre em contato com o suporte; não-membros podem se juntar ao ORCID Grupo de usuários da API.
Você pode verificar o status do nosso servidor de produção e do servidor sandbox chamando o seguinte:
Sandbox
- https://pub.sandbox.orcid.org/{{version}}/pubStatus
- https://api.sandbox.orcid.org/{{version}}/apiStatus
Produção
Você também pode verificar uma visão geral diária em http://status.orcid.org/
O ORCID o registro é dividido em seções individuais para tornar a leitura do registro mais rápida e consistente. Você pode primeiro ligar para uma seção para receber seu resumo e, em seguida, ligar usando o código de colocação de um item individual para receber informações robustas sobre aquele item.
Uma tabela das seções de resumo que você pode usar a API para ler é apresentada a seguir.
Ponto final | Descrição |
/registro | Visão resumida do completo ORCID registro |
/pessoa | Seção biográfica do ORCID registro, incluindo por meio de / researcher-urls abaixo |
/resumo | Visão resumida dos itens validados e autoafirmados no ORCID registro (disponível apenas com a API do membro) |
/Morada | Os países ou regiões do pesquisador |
/o email | Os endereços de e-mail associados ao registro |
/ external-identifiers | Identificadores externos vinculados em outros sistemas |
/palavras-chave | Palavras-chave relacionadas ao pesquisador e seu trabalho |
/outros nomes | Outros nomes pelos quais o pesquisador é conhecido |
/detalhes pessoais | Dados pessoais: nome do pesquisador, nome de crédito (publicado) e biografia |
/ researcher-urls | Links para as páginas pessoais ou de perfil do pesquisador |
/Atividades | Resumo da seção de atividades do ORCID registro, incluindo por meio de / obras abaixo. |
/ educations | Afiliações de educação |
/ empregos | Afiliações de emprego |
/ fundings | Resumo das atividades de financiamento |
/ peer-reviews | Resumo das atividades de revisão por pares |
/trabalho | Resumo dos trabalhos de pesquisa |
/ research-resources | Resumo dos recursos de pesquisa |
/Serviços | Resumo dos serviços |
/ qualifications | Sumário de qualificações |
/ membros | Resumo de associações |
/ distinções | Resumo das distinções |
/ convidados-posições | Resumo das posições convidadas |
Para apoiar o componente social, oferecemos um kit de ferramentas de Recursos de divulgação para ajudá-lo a desenvolver uma campanha para apoiar sua integração e se comunicar com seus pesquisadores:
- O Quê ORCID é.
- Por que seu sistema coleta IDs e como seu sistema executará tarefas, como atualizar seus registros.
- Por que seus pesquisadores se beneficiarão com a criação de um ORCID iD e conectando seus iDs ao seu sistema.
- Como funciona o dobrador de carta de canal ORCID beneficia a comunidade de pesquisa global mais ampla.
Estaremos construindo continuamente essa “biblioteca” de recursos com base no feedback da comunidade. Se você tiver uma ideia sobre algo que gostaria de ver, não hesite em nos contatar.
Este exemplo de chamada recupera um resumo do completo ORCID registro em formato XML usando a API membro no servidor sandbox. Você precisa de um token de acesso para fazer solicitações de API para a API Pública ou Membro.
Method: GET Accept: application/vnd.orcid+xml
Authorization type and Access token:
Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
A API retornará uma mensagem 200 OK, indicando que a solicitação foi recebida com sucesso e o resumo completo do ORCID registro, incluindo resumos de itens individuais.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
Cada item (trabalho, financiamento, emprego, etc.) tem um colocar código. Isso pode ser usado para obter detalhes completos do item, se necessário.
Itens (obras, emprego, financiamento, revisão por pares, etc.) podem ser adicionados a um ORCID gravar manualmente ou usando o ORCID API membro. Se você é um indivíduo que deseja atualizar seu cadastro, confira nosso seção de ajuda sobre isso aqui. Se você é um membro e deseja adicionar itens a um ORCID registro, você precisará do seguinte:
- A permissão dos pesquisadores
- Credenciais de API de membro
- E também:
- Um sistema de fornecedor que se integra com o ORCID API de membro
- Seu próprio sistema que se integra com o ORCID API de membro
Para obter um guia completo para membros que usam a API para registrar itens, confira nosso link do tutorial da API abaixo:
Antes de adicionar um item ao ORCID registro, você precisará formatar seus dados no ORCID esquema. Formate seus dados no ORCID esquema de mensagem em XML ou JSON.
Nosso repositório GitHub contém recursos que ajudarão na formatação ao criar novos itens no ORCID registro, e ao ler itens existentes no ORCID registro:
observe que diferentes versões da API têm diferentes formatos de mensagem. Esquemas e exemplos da versão 2.0 e 2.1 também estão disponíveis.
Mais exemplos podem ser facilmente encontrados lendo os metadados de um registro bem preenchido.
Os tokens de atualização são usados para gerar tokens de acesso adicionais. Um token de atualização é retornado com o token de acesso ao trocar um código de autorização como parte do processos OAuth de três etapas, e pode ser usado enquanto o token de acesso permanecer ativo.
Os novos tokens de acesso podem ter a mesma expiração e escopos do token de acesso original ou podem ser especificados para ter uma vida útil mais curta, bem como um subconjunto menor de escopos do token de acesso original. Novos tokens de acesso podem ser gerados para substituir o token original ou gerados para servir como um token adicional. Você também pode usar chamadas de token de atualização para expirar totalmente o acesso original e tokens de atualização e quaisquer permissões concedidas pelo usuário.
Sugerimos o uso de tokens de atualização nas seguintes condições:
- Substituindo tokens de acesso que podem ter sido comprometidos (certifique-se de revogar o token de acesso original após)
- Dar a um terceiro que também faz parte de sua ORCID integração acesso mais limitado e / ou acesso por tempo limitado.
Por favor, consulte o nosso documentação técnica sobre como criar novos tokens de acesso a partir de tokens de atualização.
Versão anterior do ORCID API tinha escopos adicionais. Esses escopos foram eliminados com a API 2.0. Incentivamos todas as integrações a usar apenas os escopos recomendados. Para referência, os escopos anteriores estão listados abaixo com o escopo atual que deve ser usado
- /orcid-profile/leitura-limitada use ao invés / read-limited
- /orcid-works/leitura-limitada use ao invés / read-limited
- /orcid-bio/leitura-limited usar em vez disso / read-limited
- /orcid-works/criar use ao invés / atividades / atualização
- /orcid-works/atualização use ao invés / atividades / atualização
- / affiliations / create use ao invés / atividades / atualização
- / affiliations / update use ao invés / atividades / atualização
- / financiamento / criar use ao invés / atividades / atualização
- / financiamento / atualizar uso em vez disso / atividades / atualização
- /orcid-bio/atualização use ao invés / pessoa / atualização
- /orcid-bio/identificadores-externos/criar use ao invés / pessoa / atualização
Existem dois âmbitos de atualização diferentes - um para detalhes biográficos e outro para atividades.
Objetivo | Descrição | Endpoints API |
/ pessoa / atualização | Dados biográficos - a coluna da esquerda do ORCID interface de usuário de registro. | /Morada / external-identifiers /palavras-chave /outros nomes / researcher-urls |
/ atividades / atualização | Dados da atividade de pesquisa - a coluna direita da ORCID interface de usuário de registro. | /distinção / distinções /Educação / educations /emprego / empregos /financiamento / fundings / posição-convidado / convidados-posições /Filiação / membros / peer-review / peer-reviews /qualificação / qualifications / research-resource / research-resources /serviço /Serviços /trabalhos /trabalho |
Use seu ID de cliente, segredo e o token ativo ou seu token de atualização associado para revogar o par de tokens. Você pode revogar pares de tokens criados em ambas as etapas e processos OAuth de três etapas. Se você tiver vários conjuntos de tokens, por exemplo, para escopos diferentes, apenas o token de acesso especificado e o token de atualização correspondente serão revogados.
Sugerimos revogar tokens nas seguintes condições:
- Revogar tokens emitidos para um fornecedor terceirizado após o término de um relacionamento;
- Para revogar tokens quando os usuários desconectam seus ORCID iD do seu sistema;
- Para permitir que os usuários revoguem tokens de dentro do seu sistema.
Recomendamos o uso do tokens de atualização para limitar o escopo ou a duração de um token de acesso existente ou atualizar um token se ele tiver sido comprometido.
A chamada de revogar API
https://sandbox.orcid.org/oauth/revoke (or https://orcid.org/oauth/revoke)
METHOD: POST
HEADER: accept:application/json
CONTENT-TYPE: application/x-www-form-urlencoded
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
token=[access token or refresh token for token pair to be revoked]
Todos os itens (exceto o texto da biografia) em um ORCID registro tem um colocar código:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0"> [...]
</record:record>
Este código put pode ser usado para fazer uma chamada à API para recuperar os dados completos de um item. Os seguintes itens podem ser consultados usando um colocar código:
Ponto final | Descrição |
/ endereço / [colocar código] | Um país ou região individual |
/biografia | O campo da biografia: área de texto livre que só o pesquisador pode editar |
/ educação / [colocar código] | Um item de afiliação educacional individual |
/ email / [colocar código] | Um endereço de e-mail individual associado ao registro |
/ emprego / [colocar código] | Um item de afiliação de emprego individual |
/ external-identifier / [colocar código] | Um identificador externo individual vinculado em outro sistema |
/ financiamento / [colocar código] | Uma atividade de financiamento individual |
/ palavras-chave / [colocar código] | Uma palavra-chave individual relacionada ao pesquisador e seu trabalho |
/ outros-nomes / [colocar código] | Um nome adicional individual pelo qual o pesquisador é conhecido |
/ revisão por pares / [colocar código] | Uma atividade individual de revisão por pares |
/ researcher-urls / [colocar código] | Um link externo individual para a página pessoal ou de perfil do pesquisador |
/ work / [colocar código] | Um trabalho de pesquisa individual |
/ works / [colocar código1], [colocar código2], [colocar código3] | Trabalhos de pesquisa individuais em massa (até 100) |
Usando o endpoint da seção e o código put, você pode chamar a API usando o mesmo token de acesso para obter aquele item específico por completo. Este exemplo de chamada recupera o item de financiamento total 4413 no formato XML usando a API membro no servidor sandbox.
Method: GET Accept: application/vnd.orcid+xml Authorization type and Access token: Bearer [stored access token]URI: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/funding/4413
A API retornará uma mensagem 200 OK para indicar que a mensagem foi recebida com sucesso e retornará o XML completo do item de financiamento:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<funding:funding put-code="4413" path="/0000-0002-9227-8514/funding/4413" visibility="public" [...] >
[...]
</funding:funding>
Você pode verificar o fonte de um item ao lê-lo, se você quiser saber quem o adicionou.
ORCID os membros podem atualizar as informações que adicionaram anteriormente a um ORCID registro. Apenas um item pode ser atualizado por vez e só pode ser atualizado usando as credenciais do cliente que o criou inicialmente.
Para facilitar a atualização, certifique-se de armazene o código de colocação e o token de acesso ao criar itens.
Formate o item atualizado in ORCID esquema de mensagem com as informações alteradas e incluir o armazenado colocar código.
<?xml version="1.0" encoding="UTF-8"?> <employment:employment put-code="739288" [...]> [...] </employment:employment>
Chame a API:
Method: PUT Content-type: application/vnd.orcid+xml or application/vnd.orcid+jsonnAuthorization type and Access token: Bearer [stored access token]Data: link to file or text of affiliation to update URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
A API retornará uma mensagem 200 OK para indicar que o item foi atualizado corretamente. Verifique nossa página de solução de problemas se uma mensagem diferente for retornada.
Uma lista de códigos de erro comuns de API, seus possíveis significados e dicas sobre como solucioná-los está disponível em nosso documentação técnica.
Se você não conseguir resolver o problema que está enfrentando, informe-nos.
Visibilidade indica a configuração de privacidade do item, com base na preferência de visibilidade definida pelo usuário. Se uma tag de visibilidade for incluída quando as informações forem postadas por meio da API, ela será ignorada. Em vez disso, as informações serão publicadas de acordo com a preferência de visibilidade padrão do usuário, conforme definido em suas preferências de conta.
Itens públicos podem ser lidos por qualquer pessoa por meio da API e são mostrados no registro público do pesquisador. Itens de partes confiáveis só são retornados por meio da API para clientes com acesso limitado de leitura; eles não estão no registro público do pesquisador. Os itens privados são visíveis apenas para o pesquisador e para a origem do item – os únicos itens privados retornados pela API são aqueles que foram adicionados ao registro por meio da sua integração Mais sobre as configurações de visibilidade no ORCID Lista de Presentes.
Itens (obras, emprego, financiamento, revisão por pares, etc.) podem ser adicionados a um ORCID gravar usando o ORCID API membro. Para fazer isso, você deve primeiro obter permissão do pesquisador usando OAuth e a formatar os metadados do item usando o ORCID esquema de mensagem.
Depois de formatar os dados e coletar os ORCID iD e token de acesso, você faz uma solicitação de API usando HTTP POST, especificando o endpoint relevante.
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
A chamada abaixo adiciona um novo emprego afiliação a um registro no servidor de teste sandbox:
<?xml version="1.0" encoding="UTF-8"?>
<employment:employment [...]>
[...]
</employment:employment>
A API retornará uma mensagem 201 para indicar que o item foi postado corretamente, junto com o item colocar código. Seu cliente será listado como o fonte do item.
Confira nossa solução de problemas página se uma mensagem diferente for retornada. Você precisará salvar o armazene o código de colocação e o token de acesso para fazer atualizações ou remover o item.
O ORCID a API de pesquisa usa a sintaxe SOLR. Todas as sintaxes de consulta disponíveis em SOLR 3.6 são suportadas, incluindo Lucene com extensões Solr (Padrão), DisMax e Extended Dismax.
Você precisa de um token de acesso “/ read-public” para usá-lo. Depois de obter seu token de pesquisa, crie seu URL de pesquisa de base:
Tipo de credencial: | API pública | API de membro |
URL do recurso: | Caixa de areia: https://pub.sandbox.orcid.org Produção: https://pub.orcid.org | Caixa de areia: https://api.sandbox.orcid.org Produção: https://api.orcid.org |
Versão API: | v3.0 | |
Ponto final de pesquisa | / search /? = [consulta] |
Um exemplo de chamada para pesquisar por “orcid” com o token na API pública do sandbox com os resultados retornados no formato XML é:
Method: GET Content-type: application/vnd.orcid+xmlnAuthorization type and Access token: Bearer [stored access token]URL: https://pub.sandbox.orcid.org/v3.0/search/?q=orcid
Os resultados irão especificar o número de resultados encontrados (num-found) e exibir os primeiros 1000 resultados por padrão:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<search:search num-found="385" xmlns:search="https://www.orcid.org/ns/search" xmlns:common="https://www.orcid.org/ns/common">
<search:result>
<common:orcid-identifier>
<common:uri>https://sandbox.orcid.org/0000-0001-2345-6789</common:uri>
<common:path>/0000-0001-2345-6789</common:path>
<common:host>sandbox.orcid.org</common:host>
</common:orcid-identifier>
</search:result>
[...]
</search:search>
Um exemplo de pesquisa básica na API pública do sandbox com resultados retornados no formato json:
Method: GET
Content-type: application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.sandbox.orcid.org/v3.0/search/?q=newman
A pesquisa retorna apenas o indivíduo ORCID IDs de registros contendo dados públicos correspondentes à pesquisa. Para obter mais informações sobre o resultado, faça uma chamada para ler o ORCID gravar diretamente.
Para mais informações, consulte as nossas Tutorial de API de pesquisa.
Se você adicionou dados que precisam ser excluídos, por exemplo, se eles foram associados ao ORCID iD, então você pode fazer uma solicitação HTTP DELETE especificando o ponto final relevante, juntamente com o ORCID eu ia, token de acesso armazenado e código de colocação armazenado. Apenas um item pode ser excluído por vez e você só pode excluir itens adicionados pelo seu cliente. Você pode excluir itens mesmo quando o usuário revogou a permissão.
Este exemplo de chamada exclui o item de emprego com o código put “739288” de um registro ”
Method: DELETE
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
Em situações do mundo real, as interações da API são concluídas por seu sistema usando uma linguagem de programação como PHP, Java ou Ruby on Rails. Para praticar e testar, você pode interagir com o ORCID APIs usando uma variedade de ferramentas capazes de fazer e receber solicitações HTTP. A maioria das ferramentas HTTP de desktop são executadas na linha de comando; para quem prefere uma interface gráfica, as ferramentas baseadas na web são uma alternativa útil.
VERIFICAÇÃO XML / XSD
Existem muitas ferramentas que verificarão seu XML para você; é uma boa ideia adotar um. Para muitas das chamadas de API, você trabalhará com informações formatadas em XML. Particularmente ao trabalhar com o ORCID Mensagem da API, será importante que o XML que você usa seja válido em relação ao XSD. (Veja nosso documentação no GitHub para o ORCID esquema de mensagem XSD.)
ORCID SERVIDOR DE TESTE SANDBOX
O servidor de teste sandbox é uma cópia do ORCID Software de registro e contém apenas dados de teste. Ele foi projetado para fornecer um lugar para experimentar coisas sem afetar qualquer ORCID IDs, especialmente se você estiver trabalhando com o ORCID API e precisa de um local para testar seu trabalho. Você pode criar contas de usuário e testar chamadas de API no sandbox sem precisar se preocupar em afetar os dados de produção ou enviar spam acidentalmente aos pesquisadores.
Você nem precisa ser um ORCID membro para experimentar a API membro na sandbox. Todos são bem-vindos para solicitar credenciais da API do membro do sandbox e experimentar todos os recursos disponíveis para a API do membro.
O site e as APIs não serão tão confiáveis quanto são para os servidores de produção. Não oferecemos garantias sobre os dados no sandbox; eles não são armazenados em backup e podem ser excluídos. A sandbox também pode conter algumas funcionalidades experimentais que ainda não estão nos servidores de produção, para que você possa experimentar antes que elas existam no Registro. Saiba Mais sobre o servidor de teste sandbox ou solicitar credenciais de cliente.
FERRAMENTAS HTTP
Existem muitas ferramentas disponíveis para executar solicitações HTTP. Alguns nós usamos:
O ORCID a API de pesquisa usa a sintaxe SOLR. Todas as sintaxes de consulta disponíveis em SOLR 3.6 são suportadas, incluindo Lucene com extensões Solr (Padrão), DisMax e Extended Dismax.
Você pode usar uma pesquisa por campo quando precisar pesquisar uma seção específica do ORCID registro. A lista atual de campos reconhecidos na pesquisa da API, junto com seus elementos de estrutura de registro correspondentes, são os seguintes:
Campo de pesquisa | Descrição |
Dados biográficos | |
recebem nomes | O (s) nome (s) fornecido (s) do usuário. |
sobrenome | O nome de família (sur) do usuário. |
nome de crédito | O “nome publicado” no ORCID interface do usuário, o nome que normalmente aparece nas publicações do usuário |
outros nomes | Nomes alternativos que podem ter aparecido nas publicações do usuário. |
O endereço de e-mail do usuário. | |
palavra chave | Qualquer palavra-chave associada ao usuário. |
referência de identificação externa | Identificadores de outros sistemas adicionados ao usuário ORCID gravar usando a API. |
Dados de afiliações | |
nome da organização de afiliação | O nome de qualquer organização em um item de educação ou emprego no registro do usuário. |
grade-org-id | O ID DE GRADE de qualquer organização na seção de atividades do registro do usuário. Geralmente, isso será associado a um item de educação ou emprego. |
ror-org-id | O ID ROR de qualquer organização na seção de atividades do registro do usuário. Geralmente, isso será associado a um item de educação ou emprego. |
ringgold-org-id | O ID do anel de ouro* de qualquer organização na seção de atividades do cadastro do usuário. Geralmente isso estará associado a um item de educação ou emprego. |
Dados de financiamento | |
títulos de financiamento | O título de qualquer item de financiamento no registro do usuário. |
Fundref-Org-Id | O ID de registro do financiador Crossref de qualquer organização na seção de atividades do registro de um usuário. Geralmente, isso estará associado a um item de financiamento, mas também pode estar associado a uma afiliação. |
números de concessão | Número de concessão (identificador) de qualquer item de financiamento no registro do usuário. |
Dados de atividades de pesquisa | |
títulos de trabalho | Os títulos de qualquer trabalho no registro do usuário. |
IDs de objetos digitais | Um identificador externo de trabalho com o tipo doi |
faça você mesmo | Um identificador externo de trabalho com o tipo doi e o relacionamento do identificador externo definido como self |
[tipo de identificador externo] * | Um identificador externo de trabalho com o tipo fornecido |
[tipo de identificador externo] * - próprio | Um identificador externo de trabalho com o tipo fornecido e o relacionamento do identificador externo definido como self |
[tipo de identificador externo] * - parte de | Um identificador externo de trabalho com o tipo fornecido e o relacionamento do identificador externo definido como parte de |
[tipo de identificador externo] * - versão de | Um identificador externo de trabalho com o tipo fornecido e o relacionamento do identificador externo definido para a versão de * Para obter uma lista completa de identificadores externos, consulte o lista de identificadores. Alguns identificadores podem exigir “-self”, “-part-of” ou “-version-of” para retornar resultados |
ORCID dados de registro | |
orcídio | Os 16 dígitos ORCID identificador do usuário, no formato 0000-0001-2345-6789. |
data de envio do perfil | A data e hora em que o registro foi criado. |
data da última modificação do perfil | A data e hora em que o registro foi modificado pela última vez. |
Todos os dados | |
texto | Todos os campos acima. Este também é o campo padrão para consultas de sintaxe Lucene. |
veja nossa Tutorial de API de pesquisa para obter mais informações.
*Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações
A URL para cancelar o registro de um webhook é a mesma para registrar. No entanto, você precisa usar o método HTTP DELETE.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
HEADER: Authorization: Bearer [Your access token]
HEADER: Content-Length: 0
METHOD: DELETE
A resposta deve ser 204 No Content
.
HTTP/1.1 204 No Content
Server: Apache-Coyote/1.1
Date: Fri, 05 Apr 2013 12:49:17 GMT
Webhooks podem ser registrados por membros premium contra qualquer ORCID registrar no registro. As etapas são:
Codifique o URL
Codifique em URL o URL que você deseja ORCID para chamar quando o registro do usuário é atualizado. Por exemplo, o seguinte URL:
https://nowhere2.com/0000-0002-7465-2162/updated
torna-se
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Construa o URL
Crie o URL completo para o ORCID Chamada de API começando com o URL do ORCID registro, em seguida, adicionando ‚√∫/webhook‚√π e a URL que você quer chamar. Então deve ficar assim: https://api.sandbox.orcid.org/{ORCID} / webhook / {URL-ENCODED-WEBHOOK-URL}
Por exemplo, usando o URL do webhook acima e o ORCID iD 0000-0002-7465-2162, o URL completo é:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Registre o webhook
Use seu token de acesso de webhooks para registrar seu webhook no usuário ORCID registro. Você precisa usar uma solicitação HTTP PUT, mas não deve incluir nada no corpo da solicitação.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdatedn HEADER: Accept: application/json HEADER: Authorization: Bearer [Your access token]n HEADER: Content-Length: 0n METHOD: PUT
A resposta deve ser 201, mas se o retorno de chamada já existir, a resposta será 204.
HTTP/1.1 201nServer: nginx/1.1.19nConnection: keep-alive Location: https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Frequestb.in%2Fz57lzcz5
O ORCID O registro fará a seguinte chamada HTTP quando um registro for atualizado. A solicitação usa o método HTTP POST, mas o corpo da solicitação está vazio.
curl -v -X POST https://nowhere2.com/0000-0002-7253-3645/updated
Seu servidor deve responder com códigos de resposta HTTP padrão. Portanto, se a chamada for bem-sucedida, você deve retornar 204 Sem conteúdo.
HTTP/1.1 204 No Content
Qualquer código de resposta 2xx significa que a chamada foi bem-sucedida. Se você retornar um código que não seja 2xx, tentaremos ligar novamente cinco minutos depois.
O ORCID o registro oferece suporte à “negociação de conteúdo”. Isso significa que as máquinas e outros sistemas podem pedir ORCID registro de metadados pessoais em diferentes formatos.
Um desses formatos é JSON-LD, que usa o schema.org vocabulário, especificamente o tipo de pessoa, que conectamos com obras, organizações e outros identificadores. Também oferecemos suporte a XML, JSON, RDF XML e tartaruga, e implementamos compartilhamento de recursos entre origens (CORS) para facilitar o acesso aos nossos dados.
Em situações do mundo real, as interações da API são concluídas por seu sistema usando uma linguagem de programação como PHP, Java ou Ruby on Rails. Para praticar e testar, no entanto, você pode interagir com o ORCID API usando uma gama de ferramentas capazes de fazer e receber solicitações HTTP. A maioria das ferramentas HTTP de desktop (como cURL) são executados na linha de comando; para quem prefere uma interface gráfica, as ferramentas baseadas na web são uma alternativa útil.
Uma ferramenta popular é OAuth 2.0 Playground do Google, uma ferramenta gratuita baseada na Web desenvolvida e mantida pelo Google.
Veja nosso tutorial prático de API em: https://info.orcid.org/hands-on-with-the-orcid-api/
Observação: ORCID não mantém o OAuth 2.0 Playground - esta ferramenta foi criada pelo Google, que mantém exclusivamente o seu código. Embora atualizemos esta documentação periodicamente, pode haver algumas imprecisões de vez em quando, pois podemos não estar imediatamente cientes das alterações no OAuth 2.0 Playground.
O controle do pesquisador é fundamental ORCID princípio então endereços de e-mail registrados e adicionados ao ORCID registro são, por padrão, definidos como visíveis apenas para o detentor do registro. Os emails não verificados não são exibidos na exibição pública do registro e apenas os endereços de email verificados aparecerão nos resultados da API.
Uma vez que os pesquisadores verificaram seu endereço de e-mail, eles devem escolher torná-lo visível para todos (ou seja, público) ou para partes confiáveis (ou seja, acesso limitado) para que o endereço de e-mail seja lido por organizações terceirizadas.
Se o pesquisador tiver definido seu endereço de e-mail como Partes confiáveis, ele será devolvido com o registro se o pesquisador tiver concedido a você acesso limitado de leitura. Para mais informações, veja ORCID configurações de visibilidade.
Para nossa API versão 2.0 e acima, os limites são:
- Solicite um segundo - 24
- Explosão - 40
Solicitar um segundo - Número de solicitações que podem ser feitas por segundo.
Burst - Número de solicitações que permitiremos que sejam colocadas na fila antes de rejeitar. As solicitações na fila são reduzidas para a taxa de solicitações por segundo. Se você exceder o burst, obterá uma resposta 503.
Se você tiver problemas com os limites, entre em contato com o líder da equipe de engajamento para obter suporte.
Por favor, consulte a ORCID página de sistemas habilitados para fornecedores para editores para obter as informações mais atualizadas
API 3.0 é a versão padrão da API e recomendamos que você use esta versão ao construir novas integrações. Continuaremos a oferecer suporte à API 2.0 e 2.1 no futuro previsível e forneceremos um aviso com pelo menos 12 meses de antecedência antes de desligar essas versões.
Aprendemos muito durante a transição da API 1.2 para a API 2. Desta vez, tornamos a atualização muito mais fácil de gerenciar. API 3.0 adiciona novas funcionalidades, ao mesmo tempo que modifica a funcionalidade existente quando absolutamente necessário. Isso significa que os integradores devem ser capazes de mudar para a nova API com o mínimo de confusão. Isso também significa que, embora recomendemos que você comece a planejar sua atualização o mais rápido possível para que sua organização e pesquisadores possam se beneficiar dos novos recursos, você tem bastante flexibilidade para decidir quando atualizar para 3.0.
A pequena lista de mudanças potencialmente importantes está em nossas notas de versão da API aqui e a aqui. Existem algumas mudanças em torno dos campos opcionais / obrigatórios, as enumerações JSON foram ligeiramente modificadas e também temos uma pequena refatoração de nossos esquemas XML, adicionando alguns novos campos para conter os metadados necessários para a nova funcionalidade.
Sim nós fazemos! Você pode ler mais sobre nosso controle de versão de API, a lógica por trás dele e muito mais, aqui em nosso Política de versão da API.
Qualquer membro premium pode obter um token de acesso '/webhook'. Um único token pode ser usado para registrar webhooks para vários registros. Para obter um token, você faz uma chamada para o ORCID Ponto de extremidade do token da API.
Esse processo geralmente é conhecido como fluxo OAuth de credenciais do cliente ou OAuth de 2 etapas.
Abaixo está um exemplo de chamada para obter o token de acesso - substitua os marcadores pelas suas credenciais (certifique-se de remover os colchetes).
curl -i -L -H "Accept: application/json"
-d "client_id=(your client ID)"
-d "client_secret=(your client secret)"
-d "scope=/webhook"
-d "grant_type=client_credentials"
"https://sandbox.orcid.org/oauth/token"
Em seguida, você receberá um token de acesso semelhante ao seguinte.
{"access_token":"5eb23750-1e19-47a3-b6f6-26635c34e8ee",
"token_type":"bearer",
"refresh_token":"c7d3d5fd-e4c0-4825-89f2-7cfb4a1cf01e",
"expires_in":631138518,
"scope":"/webhook"}
Esta seção mostra quantas autenticações suas integrações estão processando
Usuários OAuth mensais únicos
Número de horas extras de usuários que se conectaram à(s) sua(s) integração(ões) via OAuth. Observe que esses dados são amostrados, o que significa que os números fornecidos são estimados por extrapolação de um subconjunto da atividade do usuário.
Esta seção mostra quantos ORCID os registros estão conectados ao (s) seu (s) domínio (s) de e-mail
IDs com domínio (s) de e-mail:
Uma métrica que conta o número total de IDs que possuem um endereço de e-mail terminando em um dos domínios registrados. Se desejar adicionar domínios adicionais, informe-nos.
Emails com domínio (s) ao longo do tempo:
Um gráfico que mostra o uso de domínios registrados ao longo do tempo. Os pesquisadores podem ter registrado mais de um endereço de e-mail, e este gráfico conta todos os endereços do pesquisador.
Distribuição de domínio:
Um gráfico mostrando a divisão dos domínios de e-mail correspondentes aos domínios registrados. Por exemplo, se example.com estiver registrado, isso mostrará a divisão entre “apple.example.com” e “banana.example.com”
Observe que os domínios de e-mail não são uma fonte confiável de dados a ser usada para o número de pesquisadores em sua organização. Muitos pesquisadores usam serviços de webmail genéricos.
À medida que continuamos a desenvolver nossos produtos, vários recursos estão disponíveis apenas com a API 3.0, que é nossa versão mais recente e padrão da API.
A tabela abaixo fornece uma breve descrição de cada recurso. Se você tiver alguma dúvida sobre qualquer um dos recursos ou atualização para 3.0, entre em contato com seu líder de engajamento ou líder de consórcio.
Capacidade de ler e escrever todos os tipos de afiliação (associação, serviço, posições convidadas, distinções e qualificações não estão disponíveis nas versões anteriores da API) |
Capacidade de ler e escrever recursos de pesquisa. |
Capacidade de ler e escrever identificadores de trabalho com tipo de relacionamento 'Financiado por'. Isso é usado para vincular IDs de concessão ou proposta aos metadados de trabalho. |
Capacidade de ler e escrever identificadores de trabalho com tipo de relacionamento 'Versão de'. Isso é usado para vincular outras versões do trabalho. Um exemplo de caso de uso seria vincular a pré-impressão e o artigo publicado. |
Capacidade de ler e escrever funções CRediT em metadados de trabalho. |
Capacidade de ler os campos de fonte adicionais comum: assertion-origin-client-id e a comum: assertion-origin-name para afiliações adicionadas pelo ORCID portal de membros e trabalhos adicionados por assistentes de pesquisa e link. |
Capacidade de ler e escrever trabalhos com tipo de trabalho de: anotação planos de gerenciamento de dados tese de dissertação pré-impressão objeto físico rever |
Capacidade de ler e escrever IDs externos para afiliações. |
Os IDs da organização são obrigatórios para adicionar afiliações e financiamento para ORCID Registros. |
Formalizando Identificadores – Introduzimos um novo campo gerado pelo sistema, que expressa identificadores externos (DOIs, PMCID, PMID, ArXiv, Bibcode, ISSNs e ISBNs) em um formato normalizado para fins de correspondência e agrupamento. A normalização é feita com base nas regras do tipo de identificador, podendo incluir a colocação de todos os caracteres alfabéticos em minúsculos, ou a transformação de espaços, hífens, pontos e outros caracteres que possam ser tratados como equivalentes. Ele também adiciona prefixos e sufixos padrão conforme apropriado. Por exemplo, https://doi.org/10.1/123, 10.1/123 e https://dx.doi.org/10.1/123 todos aparecerão neste campo como https://doi.org/10.1/123. O valor do identificador existente não foi modificado. |
Informações mais detalhadas podem ser encontradas aqui.
Leituras de API: número de chamadas de API GET horas extras que sua integração fez.
Eventos mensais de login de integração (janeiro de 2024 em diante): Número de horas extras de login que se conectaram à sua integração via OAuth.
Procurando um usuário usando cURL assim:
curl -iL https://orcid.org/0000-0000-0000-0000
Retornará 200 mesmo se o usuário não existir. Para evitar isso, use a negociação de conteúdo em sua chamada da seguinte maneira:
curl -iL -H 'Accept: application/xml' https://orcid.org/0000-0000-0000-0000
O processo para obter permissão para adicionar ou atualizar dados em um usuário ORCID registro usa OAuth, conforme descrito em nosso Perguntas frequentes sobre o OAuth de três etapas. Apenas ORCID os membros podem usar a API de membros para solicitar permissões de atualização. Em termos simples, funciona assim:
- Seu sistema local cria um link especial
- Quando clicado, o usuário é enviado para ORCID, faz login e concede permissão
- ORCID envia o usuário de volta ao seu sistema com um 'código de autorização'
- Seu sistema troca esse código por um 'token de acesso'
- O token de acesso permite que você atualize o registro do usuário
Integração ORCID em seu sistema permite que sua organização colete dados autenticados ORCID IDs e adicione-os aos seus próprios dados. Ao mesmo tempo, o pesquisador fornece à organização permissão para ler e escrever de e para seus ORCID registro.
Para fazer isso funcionar, as organizações DEVO obter autenticado ORCID IDs usando o ORCID API OAuth. Isso significa que eles incluem um ORCID botão ou link da marca em seu sistema que, quando clicado, solicita ao usuário que faça login em seu ORCID registro.
Uma vez logado, o usuário será solicitado a autorizar o acesso ao sistema solicitando seu ORCID iD
O usuário ORCID iD e nome no ORCID O registro (dependendo das configurações de visibilidade) é devolvido à organização como parte deste processo. O sistema pode então solicitar dados adicionais do ORCID API.
O fluxo de trabalho descrito acima para coletar APIs autenticadas está disponível em ambos ORCIDAPIs públicas e de membros. O primeiro está disponível para utilização gratuita por serviços não comerciais.
Você pode ajudar a tornar a vida mais fácil para seus usuários conectando informações validadas a seus ORCID registros. Você também estará ajudando a construir confiança nas comunicações acadêmicas e, ao manter esses dados atualizados, poderá reduzir a carga de relatórios para seus usuários e melhorar a qualidade dos dados.
ORCID para organizações de pesquisa
Além de seu uso como um identificador persistente para seus pesquisadores, ORCID pode ajudá-lo a controlar como o nome de sua instituição é usado nos sistemas de pesquisa. Em combinação com outros identificadores persistentes ORCID permite que você afirme com autoridade sua equipe, corpo docente e afiliações de alunos com sua instituição. Você também pode usar ORCID APIs para receber notificações em tempo real sobre atividades de pesquisa, para atualizar formulários automaticamente e para acompanhar a carreira de seus ex-alunos.
ORCID para Organizações de Financiamento
Incorporando ORCID IDs em seus fluxos de trabalho de financiamento, você pode conectar de forma confiável seus financiados e programas de financiamento - e economizar tempo de todos e reduzir erros causados pela digitação manual de informações. Usando ORCID em seu (s) sistema (s), você pode desempenhar sua parte na construção de uma infraestrutura de informações de pesquisa confiável, estabelecendo conexões entre os indivíduos e as bolsas que você lhes concedeu.
ORCID para editores
Os pesquisadores estão no centro de tudo o que os editores acadêmicos e de pesquisa fazem. As informações precisas do autor e do revisor são vitais para a indexação, pesquisa e descoberta, rastreamento de publicação, atribuição de financiamento e uso de recursos e apoio à revisão por pares.
ORCID serve como um centro de informações, permitindo que seus autores e revisores se conectem de forma confiável às suas contribuições e compartilhem informações de seus ORCID gravar conforme eles interagem com seus sistemas de publicação. A coleta de IDs para todos os seus autores e revisores durante o processo de publicação - seja para livros, periódicos, conjuntos de dados, composições, apresentações, códigos ou uma variedade de outros trabalhos - permite que as informações sejam facilmente compartilhadas, garante que os pesquisadores possam fornecer consentimento para compartilhar, economiza tempo e trabalho dos pesquisadores, reduz o risco de erros e, de forma crítica, permite que os pesquisadores recebam o crédito que merecem pelo importante trabalho que estão realizando.
ORCID se esforça para permitir conexões transparentes e confiáveis entre pesquisadores, suas contribuições e suas afiliações, fornecendo um identificador único e persistente para os indivíduos usarem enquanto se envolvem em atividades de pesquisa, bolsas de estudo e inovação. Garantindo que o correto ORCID iD está associado ao pesquisador certo é um passo crítico na construção da confiabilidade do ORCID conjunto de dados e o ecossistema mais amplo de comunicações acadêmicas. Por esta razão, ORCID não permite a coleta ou entrada manual de ORCID IDs em qualquer fluxo de trabalho onde seja possível coletar ORCID IDs diretamente dos próprios detentores de registros.
Os pesquisadores podem compartilhar de forma fácil e segura seus ORCID identificam os sistemas com os quais interagem, o que prova que são donos de seus ORCID eu ia. Esses sistemas podem então partilhar informações sobre as atividades dos investigadores com outros sistemas, o que cria uma cadeia de afirmações validadas e confiáveis sobre as atividades dos investigadores. O resultado final é que a pessoa certa está associada às atividades corretas em uma ampla gama de fluxos de trabalho de informação acadêmica.
Para mais informações, veja: https://info.orcid.org/collecting-and-sharing-orcid-ids/
Além de ter acesso à API membro, você também se beneficia de:
- Suporte técnico e de comunicação de ORCID funcionários, que estão baseados em 14 países ao redor do mundo e que coletivamente falam 13 idiomas
- Sendo listado como a fonte de informação que você adiciona ORCID registros
- Receber relatórios regulares sobre o uso de seu ORCID integração (mensal para membros premium, duas vezes por ano para membros básicos)
- Recebendo aviso prévio de ORCID notícias, atualizações e eventos por meio de nosso boletim informativo mensal para membros
- Ser capaz de nomear alguém de sua organização para representar o ORCID Conselho e votação em nossas eleições anuais do Conselho
ORCID a assinatura permite que você faça mais do que apenas coletar ORCID IDs. Isso dá a você o direito de acessar o ORCID API de membro, o que significa que você pode conectar informações aos seus autores‚ e revisores‚ ORCID registros, e você pode ler informações em seus registros que eles marcaram como partes confiáveis (ORCID membros), bem como suas informações publicamente disponíveis.
Qualquer jornal ou organização pode coletar IDs sem aderir ORCID, usando nossa API pública. ORCID a associação exige que seu jornal pague uma taxa anual de associação.
. complete este formulário ou contacte-nos [email protegido]
Você pode verificar a nossa lista de membros¬¨‚
Seu jornal não será um membro no sentido de que você pode obter suporte técnico direto ou representar o ORCID Conselho / voto nas eleições do Conselho. Mas, dependendo do tipo de associação que seu editor ou instituição possui, você pode ter acesso a outros benefícios de membro, como usar a API de membro.
Sim - nossas taxas estão disponíveis em nosso Página de adesão
Por favor consulte o nosso Diretrizes de marca para exibir ORCID em artigos de jornal.
Sim (veja a pergunta 10)
- A API pública está disponível para uso de todos. Deve estar vinculado a um usuário individual ORCID iD e, se esse indivíduo deixar sua organização, você precisará configurar um novo conjunto de credenciais. Você pode usar a API pública para coletar autenticação ORCID IDs e para ler as informações disponíveis publicamente em ORCID registros
- A API membro está disponível apenas para membros. Além de coletar IDs autenticados e ler informações disponíveis publicamente, você também pode ler informações marcadas como Partes confiáveis e conectar informações a ORCID registros, por exemplo, sobre as publicações de seus autores. A associação básica dá direito a um conjunto de credenciais (uma integração), enquanto a associação premium fornece até cinco conjuntos de credenciais (cinco integrações)
ORCID a atualização automática permite que os autores tenham seus ORCID registros atualizados automaticamente. Funciona assim:
- A editora coleta as informações do autor ORCID iD durante o processo de publicação (geralmente durante a submissão do manuscrito)
- O editor inclui o iD nos metadados ao registrar um DOI para a publicação
- O autor recebe um e-mail do registro DOI (atualmente Crossref) pedindo permissão para atualizar seu registro OU o autor cria um perfil DataCite e o vincula ao seu ORCID registro
- O autor concede permissão Crossref ou DataCite para atualizar seus ORCID registro (eles só precisam fazer isso uma vez)
- Cada vez que Crossref ou DataCite registram um DOI que inclui o autor ORCID iD eles atualizam automaticamente seus registros
Para mais informações, consulte https://www.crossref.org/community/orcid/
sim. Para obter mais informações, leia nosso documentação
ORCID IDs são apenas para indivíduos. Editores interagem com ORCID integrando-se com nossas APIs para coletar IDs e para importar e exportar dados de e para ORCID registros. Saiba mais em nosso publicação de documentação de fluxos de trabalho
DOIs são identificadores persistentes para objetos, mais comumente para publicações de todos os tipos (artigos de periódicos, livros, capítulos de livros, conjuntos de dados, etc.). ORCID iDs são identificadores persistentes para pessoas e, especificamente, para pessoas envolvidas na comunidade de pesquisa – seja diretamente como pesquisadores, autores ou revisores, por exemplo – ou em papéis de apoio, como bibliotecários, editores, financiadores, etc.
ORCID conta com dois mecanismos para transferir dados pessoais sob o GDPR. Primeiro, ORCID obtém o consentimento de seus usuários no momento do registro para a transferência de dados pessoais da UE para os EUA. Segundo, ORCID entra nas Cláusulas Contratuais Padrão (SCCs) com as organizações membros, conforme necessário.
Sim, ORCID transfere dados pessoais da UE para os EUA como parte de sua infraestrutura de rede. O software de registro ativo é hospedado em servidores localizados nos Estados Unidos.
Será que ORCID Fornece medidas suplementares na transferência de dados pessoais da UE para os EUA?
Sim, além das salvaguardas discutidas acima, ORCID incorpora as seguintes medidas suplementares para abordar a proteção de dados.
Controle de titulares de dados. Os usuários recebem uma grande transparência e controle em relação às informações compartilhadas com ORCID e outros usuários ou organizações membros. ORCID tomou medidas para minimizar a quantidade de dados pessoais necessários para estabelecer um ORCID registro, exigindo apenas um nome e endereço de e-mail. Além disso, ORCID deixa claro que suas ferramentas e serviços fornecem aos usuários controle sobre o registro, o que está conectado a um ID e quem pode acessar as informações do usuário.
Contratos de processador de terceiros. ORCID celebra acordos com seus processadores que incorporam cláusulas de privacidade e segurança de dados. Antes de entrar em acordos com os processadores, ORCID conduz a devida diligência que aborda os componentes de privacidade e segurança. Para realizar esta devida diligência, ORCID primeiro determina se o provedor terceirizado terá ou não acesso e / ou receberá cópias de quaisquer Dados Pessoais. Se a resposta for sim, então ORCID segue em frente com a negociação de um contrato de processamento de dados que se alinhe aos requisitos do GDPR e a quaisquer outros requisitos de proteção de dados aplicáveis.
Criptografia de dados. ORCID implementa medidas razoáveis de criptografia para todos os dados em repouso e em trânsito. Além disso, todos os backups são criptografados.¬¨‚
Medidas técnicas e organizacionais. ORCID implementa uma variedade de controles de segurança para oferecer suporte ao gerenciamento seguro de seus bancos de dados e infraestrutura. Esses controles de segurança incluem gerenciamento de patch de segurança; monitoramento de acesso ao sistema; registro de auditoria; controle de acesso; e mecanismos de controle de mudanças. Adicionalmente, ORCID mantém um plano de resposta a incidentes, bem como um processo de recuperação de desastres e dados.
Sim, ORCID mantém uma série de documentos em seu site relacionados às suas práticas de privacidade e segurança. Esses documentos incluem:
- Política de Privacidade - ORCID
- ORCID Confiar - ORCID
- ORCID, GDPR e seus direitos como usuário ‚ORCID
Carta de Atestado TRUSTe (Microsoft Word - Carta de Atestado de Certificação_ORCID20191220.docx)
ORCID tem o prazer de entrar nas Cláusulas Contratuais Padrão com qualquer membro localizado na UE, EEE ou Reino Unido que esteja transferindo dados pessoais para ORCID usando a API membro. Por favor, entre em contato com o seu ORCID contato da equipe de trabalho para discutir a adição das cláusulas contratuais padrão ao seu contrato de associação.
Não é provável que ORCID estaria sujeito às solicitações da lei de vigilância dos EUA destacadas na decisão Schrems II. Desde a ORCID não é um “provedor de serviços de comunicação eletrônica” conforme definido na Seção 50 USC § 1881 (b) (4), não está sujeito à Lei de Serviços de Inteligência Estrangeira (“FISA”). ORCID fornece um registro online que é usado para identificar pesquisadores de organizações membros; como tal, a Seção 702 sob FISA não se aplicaria a ORCID e seus dados.
Sim, ORCID deixa claro para os usuários que, no caso de receber qualquer solicitação de dados do governo, fornecerá "apenas os dados que considerarmos necessários na situação". Ver Política de privacidade, Seç. 6.4. Avançar ORCID deixa claro que, se permitido, "fornecerá prontamente informações sobre quaisquer solicitações de dados governamentais recebidas e contas afetadas para os detentores de registros relevantes". Identidade.
Sim, ORCID não faz distinção entre usuários localizados na UE ou fora da UE.¬¨‚ Embora certas regiões possam manter leis de privacidade diferentes, ORCID se esforça para fornecer proteção de privacidade a todos os usuários de acordo com sua Política de Privacidade, localizada em https://info.orcid.org/privacy-policy/.
sim. Qualquer pessoa que participe de pesquisa, bolsa de estudos ou inovação pode registrar um ORCID iD para si próprios gratuitamente, e você pode usar o mesmo iD durante toda a sua carreira, mesmo que mude de nome ou mude de organização, disciplina ou país.
Vá para a nossa Esqueceu a senha página, selecione o Senha opção, insira seu endereço de e-mail registrado no campo de e-mail e selecione o Recuperar detalhes da conta botão. Enviaremos um e-mail com as etapas para redefinir sua senha.*
*Se não há ORCID iD associado ao endereço de e-mail que você inseriu, o e-mail que você receber de nós o informará. Nesse ponto, você pode tentar redefinir sua senha usando outro endereço de e-mail (tente pessoal e profissional). Por favor, veja nosso artigo sobre senhas esquecidas para obter mais informações.
ORCID identificadores que terminam em X são válidos e corretos.
ORCID identificadores são todos atribuídos aleatoriamente e não podem ser alterados. O último personagem em um ORCID identificador é uma soma de verificação. Ele varia em valores de “0” - “10”, com X representando o valor “10”. A soma de verificação garante que os outros 15 dígitos do seu identificador formem um ID coerente.
Você pode aprender mais lendo sobre a estrutura de um ORCID identificador.
Vá para a nossa Esqueceu a senha página, selecione o ORCID iD opção, insira seu endereço de e-mail registrado no campo de e-mail e selecione o Recuperar detalhes da conta botão.
Nós lhe enviaremos um e-mail de [email protegido], permitindo que você saiba seus 16 dígitos ORCID identificador. Por favor, veja Eu esqueci meu ORCID iD, como faço para recuperá-lo? para obter mais informações.
Se você se lembra da sua senha, tente fazer login em https://orcid.org/signin usando seus 16 dígitos ORCID iD ou seu endereço de e-mail anterior como seu nome de usuário.
Se você esqueceu sua senha E perdeu o acesso ao e-mail registrado anteriormente, por favor Contacte-nos e incluem:
- Seu nome
- ORCID ID (s) que você acha que podem pertencer a você
- Quaisquer endereços de e-mail anteriores nos quais você possa ter se registrado
- Um endereço de e-mail institucional ou comercial atual (se possível)
Esta informação tornará mais fácil para nós identificarmos potenciais ORCID registros que podem pertencer a você e fornecer um retorno mais rápido.
Por favor, veja Como posso acessar meu ORCID registre se eu não tiver mais o e-mail associado a ele Para maiores informações. Observação: para evitar que isso aconteça no futuro, recomendamos adicionando vários endereços de e-mail para o seu ORCID conta.
Se você não receber nenhum e-mail em 10 minutos, isso pode significar uma das três coisas:
- Nosso e-mail foi direcionado para sua pasta de spam ou lixo eletrônico. Verifique sua pasta de spam ou lixo para mensagens de ORCID.
- O endereço de e-mail inserido contém um erro de digitação. Por favor, tente novamente.
- Seu administrador de e-mail pode ter nossas mensagens bloqueadas. Entre em contato conosco se você acredita que este seja o caso.
O problema mais comum que ouvimos dos usuários é a perda de acesso a seus antigos endereços de e-mail registrados em suas contas.
É altamente recomendável adicionar pelo menos um endereço de e-mail de backup, para que você possa recuperar o acesso ao seu ORCID registre caso perca o acesso a outro e-mail.
Se você esqueceu qual endereço de e-mail registrou seu ORCID conta com, por favor vá para o nosso Esqueceu a senha página. Selecione os ORCID iD opção e, em seguida, insira qualquer endereço de e-mail com o qual você possa ter se registrado.
Nós lhe enviaremos um e-mail informando seu número de 16 dígitos ORCID identificador.
Se o e-mail disser que não encontramos um ORCID iD associado ao endereço de e-mail, tente novamente o processo acima com seus outros endereços de e-mail atuais (pessoais e profissionais) para recuperar o ORCID eu ia.
Quando você tiver esgotado todas as outras opções, entre em contato conosco com seu nome completo, seu nome de 16 dígitos ORCID identificador, e quaisquer endereços de e-mail que você possa ter registrado para uma conta. Observação: para evitar que isso aconteça no futuro, recomendamos adicionando vários endereços de e-mail para o seu ORCID conta.
Você pode remover de forma rápida e fácil seu registro duplicado, indo para o seu Configurações da conta e selecionando Remover registro duplicado. Você será solicitado a inserir o endereço de e-mail ou ORCID iD do registro duplicado, bem como a senha.
Quando o registro duplicado for removido, o endereço de e-mail anexado a ele será adicionado ao seu ORCID registro, e todas as outras informações no registro serão excluídas.
Para obter mais informações, consulte removendo seu adicional ou duplicado ORCID iD.
Se você não tiver mais acesso a essa conta de e-mail e não se lembrar da senha, entre em contato conosco com seu nome completo, seu nome de 16 dígitos ORCID identificador, e quaisquer endereços de e-mail que você possa ter registrado para uma conta.
Eles recebem uma notificação em seu ORCID caixa de entrada. Sempre que houver uma mudança nos dados em um ORCID registro, o usuário recebe uma notificação com informações básicas sobre a mudança, incluindo o nome do cliente que realiza a atualização, a data da mudança e o item no ORCID registro que foi atualizado. Veja nosso Base de conhecimento do usuário para mais informações sobre notificações.
ORCID registros na sandbox também têm caixas de entrada em funcionamento. Recomendamos consultar regularmente as caixas de entrada de seus testes ORCID registros ao planejar como seus sistemas irão agendar atualizações de dados.
ORCID está empenhada em ser aberta e transparente. Isso significa que nosso roteiro do produto está disponível para qualquer pessoa ver, assim como o trabalho atualmente em desenvolvimento.
O Roteiro do Produto é fundamental para o ORCID processo de desenvolvimento de produto. Os requisitos viajam de placas trello gerenciadas por equipe, por meio da placa trello Product Roadmap e daí para a placa trello de desenvolvimento atual, onde são implementados e movidos para nossos sistemas de produção.
Este quadro contém requisitos bem definidos que estão programados para implementação em algum pontoe uma lista de requisitos priorizados programados para implementação em curto prazo.
De onde vêm os requisitos?
Os requisitos são coletados de muitas fontes por ORCID pessoal. Eles podem se originar de solicitações de membros, feedback do consórcio, testes de usuários, projetos estratégicos e relatórios de erros, entre outros. Além disso, todos ORCID as equipes geram seus próprios requisitos internos, como mudanças no site, atualizações de infraestrutura e atualizações de sistemas operacionais. Cada cartão é marcado com a equipe que produziu o requisito - comunicações, estratégia, tecnologia, engajamento ou operações.
Como fazer as coisas no roteiro?
ORCID visa um ciclo de desenvolvimento de produto equilibrado e tem reuniões regulares entre equipes para discutir as prioridades de curto e longo prazo. Nós tentamos o nosso melhor para resolver bugs, novos recursos, dívida técnica, atualizações do site e itens estratégicos da mesma forma.
Como posso contribuir para o roteiro?
Aceitamos sugestões sobre como melhorar o ORCID registro. Por favor, envie qualquer feedback para nossa equipe.
Além disso, ORCID é um projeto de código aberto e agradecemos contribuições para o nosso código-fonte, bem como para todos nossos repositórios.
Atualizações e outros anúncios para usuários da API são compartilhados por meio do ORCID Grupo de usuários API. Você também pode se inscrever para receber mensagens e atualizações gerais por meio do ORCID Blog.
ORCID membros também recebem o ORCID Newsletter do Membro onde esta informação está incluída. Finalmente, o contato técnico para qualquer ORCID membro com uma integração ativa e personalizada também receberá mensagens de e-mail sobre quaisquer atualizações críticas para o ORCID Registro. Se você deseja ser listado como um contato técnico para sua organização, por favor Contacte-nos.
O boletim informativo para membros enviado mensalmente de ORCID anteriormente continha um link para uma pasta do Google Drive onde todos os relatórios de seus membros eram armazenados. Isso agora foi substituído por novos relatórios disponíveis para todos os membros no portal de membros.
Relatórios anteriores:
- Membros premium com integrações ativas receba um link exclusivo para uma pasta contendo relatórios personalizados separados com dados para cada integração no mês anterior.
- Membros premium que ainda não têm uma integração ativa receber um link exclusivo para uma pasta contendo relatórios personalizados com estatísticas de e-mail de sua instituição, bem como um link para uma pasta que contém relatórios gerais com dados agregados para todas as integrações de membros ativos.
- Membros básicos receber um link para uma pasta contendo relatórios gerais emitidos duas vezes por ano com dados agregados para todas as integrações de membros ativos no semestre anterior; o relatório do primeiro semestre do ano é emitido em Julho (Dados de janeiro a junho), o relatório do segundo semestre emitido em janeiro (Julho-dezembro do ano seguinte).
Se você é um ORCID membro e atualmente não recebe o boletim informativo mensal para membros, entre em contato [email protegido]
Membros premium com integrações ativas
A pasta do Google Drive contém um relatório de membro para cada um dos IDs de cliente de produção emitidos para você. Os nomes dos arquivos incluem o nome de exibição do cliente iD e a data do relatório; classifique por data de modificação para encontrar o relatório mais recente. Há também uma pasta raw_data contendo os dados usados para gerar o relatório, que está disponível para análise adicional, se necessário.
Membros premium que ainda não têm uma integração ativa
A pasta do Google Drive contém um relatório de membro com dados estatísticos de e-mail apenas, bem como um link para uma pasta do Google Drive de relatórios mensais gerais com dados agregados para todas as integrações de membros ativos, para o ano atual e anterior. Os dados brutos não estão disponíveis para esses relatórios.
Contagens de domínio de email
Esta seção fornece contagens de ORCID iDs registrou atualmente os domínios de e-mail de sua instituição em todos os períodos de tempo. Para gerar essas contagens, pesquisamos domínios que correspondam ao URL do site que temos registrado para sua organização (por exemplo: se o URL do site for www.universitycollege.edu, pesquisaremos e-mails que terminem em @universitycollege). Se não tivermos um URL de site registrado, você verá ‚√∫Nenhum domínio de e-mail fornecido‚√π nesta seção. Se não acertarmos seu domínio de e-mail ou se você quiser adicionar domínios adicionais, por favor Contacte-nos.
- Registros registrados em seus domínios de e-mail¬¨‚Contagem de únicos ORCID IDs que incluem um endereço no(s) domínio(s) de e-mail da sua instituição
- Registros registrados em seus domínios de e-mail E associados à sua ID de cliente¬¨‚Contagem de únicos ORCID IDs que incluam um endereço no(s) domínio(s) de e-mail de sua instituição E que incluam sua instituição como parte confiável (ou seja: registros para os quais sua instituição possui um token de acesso válido)
Registros criados e reivindicados
(Observação: a maioria dos clientes não terá esta seção em seus relatórios)
Se você tiver um cliente institucional que foi usado para criar registros em nome de pesquisadores por meio da API, receberá uma seção chamada Estatísticas do Registro. Isso inclui informações sobre o número de registros que você criou e quantos foram reivindicados (o arquivo raw_data contém mais informações sobre os registros específicos usados para gerar esses números).
Utilizadores
Esta seção do relatório contém uma contagem total do número de pesquisadores que usaram sua integração para conectar seus ORCID iD ao seu sistema ao longo do mês de relatório. Além disso, dá o número total de pesquisadores que se inscreveram para um novo ORCID iD como parte do iD processo de conexão.
O gráfico denominado Total de eventos de integração mostra o número de pesquisadores que usaram sua integração no último mês, por dia
Eventos
O relatório também contém eventos informações, as ações que o pesquisador realizou ao conectar seus ORCID registre com seu sistema no mês do relatório. Cada evento representa qualquer acesso que o usuário concedeu ou ação que ele fez no ORCID site (como entrar ou fornecer acesso limitado de leitura). A maioria dos pesquisadores terá mais de um evento associado a eles.
Se um evento tiver um ‚√∫√π anexado a ele, isso significa que o pesquisador concedeu um ( de longa duraçãoPpersistente), em comparação com um token de curta duração que expira em uma hora. Desde março de 2018, apenas tokens de longa duração são suportados no ORCID Registro; seu sistema integrado ou o usuário pode optar por revogar o token a qualquer momento.
Usuários por país
A seção final dos relatórios contém informações sobre os pesquisadores que usaram sua integração, discriminadas pelo país de onde acessaram sua integração. Esses dados são derivados do endereço IP de um pesquisador ou de seu ID geográfico (ele próprio determinado pelo Google a partir do endereço IP do pesquisador).
Amostragem
Porque tantos pesquisadores usam o ORCID Registry, não é viável executar relatórios sobre todo o conjunto de dados do pesquisador. Em vez disso, os números fornecidos aqui são produzidos usando tendências de um conjunto amostrado e não amostrado. As seções do relatório derivadas de dados amostrados são sinalizadas com um asterisco, e o tamanho e o espaço amostrados são especificados na guia Dados analíticos. Os números na seção do Google Analytics do relatório podem não corresponder totalmente a nenhuma estatística local que você mantém e pode haver pequenas discrepâncias na contagem entre as seções do relatório.
Os parâmetros de amostragem listados abaixo do Integration Analytics se aplicam a todas as seções marcadas com um asterisco. A porcentagem de sessões capturadas pelos dados analíticos é (tamanho da amostra) / (espaço da amostra) * 100%. Mais informações sobre amostragem podem ser encontradas em Google Developers.
Relatórios vazios
As seções Usuários e Eventos do relatório incluem apenas dados do mês anterior. Se nenhum pesquisador tiver usado sua integração no mês anterior, nenhum dado será retornado.
Frequentes
Se você tiver alguma dúvida sobre seus relatórios de membros, por favor Contacte-nos.
Um preprint é um manuscrito científico completo que é carregado pelos autores em um servidor público. A pré-impressão contém dados e metodologias completos; muitas vezes é o mesmo manuscrito sendo submetido a um periódico. Após uma breve inspeção de controle de qualidade para garantir que o trabalho seja de natureza científica, o manuscrito do autor é publicado em um dia ou mais na Web sem revisão por pares e pode ser visualizado gratuitamente por qualquer pessoa no mundo. Com base no feedback e/ou novos dados, novas versões de sua pré-impressão podem ser enviadas; no entanto, versões anteriores de pré-impressão também são mantidas. Os servidores de preprint permitem que os cientistas controlem diretamente a disseminação de seu trabalho para a comunidade científica mundial. Na maioria dos casos, o mesmo trabalho publicado como preprint também é submetido à revisão por pares em um periódico. Assim, preprints (rápidos, mas não validados por peer-review) e publicações em periódicos (lentos, mas com validação por peer-review) funcionam em paralelo como um sistema de comunicação para a pesquisa científica.
Nota: Este conteúdo e vídeo apareceram originalmente no Site ASAPBio Agradecemos ao ASAPBio por disponibilizá-lo sob uma licença CC-BY!
O esquema eduPerson adicionou o eduPessoaOrcid atributo em seu Atualização de fevereiro de 2016.
Conforme especificação eduPerson:
RFC4512 definition
( 1.3.6.1.4.1.5923.1.1.1.16
NAME 'eduPersonOrcid'
DESC 'ORCID researcher identifiers belonging to the principal'
EQUALITY caseIgnoreMatch
SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' )
Observe que o formato deste campo é o ORCID- representação URI preferida do iD, Isto é, https://orcid.org/0000-0001-5727-2427.
Mais informações sobre o formato do ORCID iD pode ser encontrada em Estrutura do ORCID identificador.
O ORCID O registro é projetado para que os usuários forneçam seus IDs para organizações que usam OAuth, o que garante que o correto iD é coletado para cada pesquisador. Desencorajamos as organizações de adicionar ORCID IDs para seus sistemas com base em uma pesquisa de pesquisadores por nome. No entanto, pode ser útil descobrir quantos pesquisadores em sua organização têm ORCID iDs, que pode ser feito por meio da API. Sugestões para pesquisar por organização são fornecidas abaixo.
Para obter uma introdução à pesquisa, como obter um token de acesso, como entender os resultados da pesquisa e detalhes de outros campos que podem ser pesquisados, consulte nosso Tutorial de pesquisa da API de registro
Pesquise por nome e DOI
Ao verificar se um indivíduo tem um ORCID registro, recomendamos pesquisar pelo nome e pelo DOI de um ou mais de seus trabalhos recentes. Isso deve resultar apenas no registro do pesquisador que você está procurando, e não nos registros de qualquer outra pessoa que compartilhe o mesmo nome.
Um exemplo de chamada para pesquisar todos os registros com o nome “Laurel Haak” e o DOI 10.1087 / 20120404 ou o DOI 10.6084 / M9.FIGSHARE.1115124:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search?q=family-name:Haak+AND+given-names:Laurel+AND+digital-object-ids:%2210.1087/20120404%22+OR+digital-object-ids:%2210.6084/M9.FIGSHARE.1115124’%22
Pesquisa por afiliação
Os campos de afiliação podem ser pesquisados usando o nome da afiliação ou o ROR ID exclusivo da organização ou o GRID ID. (Você pode encontrar o GRID ID da sua organização em GRID ou seu ID ROR no Registro ROR)
Pesquise pelo nome da organização
Method: GET Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:"University+of+Johannesburg"
Ou para uma correspondência exata
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:(%22Boston%20University%22)
Pesquisa por ID GRID
Um exemplo de chamada para pesquisar todos os registros com o ID GRID grid.5509.9 (Universidade de Tampere):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=grid-org-id:grid.5509.9
Pesquisa por ROR ID
Um exemplo de chamada para pesquisar todos os registros com o ROR ID 04fa4r544 (ORCID):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=ror-org-id:"https://ror.org/04fa4r544"
Pesquise por domínio de e-mail
Você pode usar a API para pesquisar pesquisadores por domínio de e-mail. Lembre-se de que cerca de 97% dos endereços de e-mail em ORCID são privados e quaisquer registros com um endereço de e-mail de acesso privado ou confiável não serão retornados nesta pesquisa.
Um exemplo de chamada para pesquisar todos os registros com um endereço de e-mail @orcid.org:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=email:*@orcid.org
Resultados da pesquisa retornados em formato CSV
Os resultados da pesquisa também podem ser retornados no formato CSV. Como parte da chamada, você pode especificar as colunas de saída de uma lista de campos disponíveis abaixo:
orcídio
email
nome dado
sobrenome
nomes próprios e de família
nome de crédito
outro nome
nome-da-instituição-afiliação-atual
nome-da-instituição-anterior
Usando suas credenciais, você precisa especificar o cabeçalho como 'text / csv '. Como parte da chamada de pesquisa, você também precisa adicionar à consulta os campos necessários na saída.
Pesquisando usando apenas seu navegador
Você também pode completar a pesquisa usando seu navegador. O URL é construído da mesma maneira, mas você não precisa usar nenhuma credencial de API. Observe que isso só pode ser concluído usando a API pública.
Abaixo está um exemplo de chamada usando a API pública pesquisando pelo nome da organização com o ORCID, nomes próprios, sobrenomes, nome de afiliação da instituição atual e nome de afiliação da instituição anterior como a saída desejada.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:ORCID&fl=orcid,given-names,family-name,current-institution-affiliation-name,past-institution-affiliation-name
Abaixo está outro exemplo de chamada usando a API pública procurando por diferentes variações do nome da organização.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:("University of Plymouth" OR "Plymouth University")
Se você acredita que os dados exibidos em seu relatório são imprecisos, Contacte-nos com o máximo de detalhes possível e nossa equipe de engajamento investigará.
ORCID foi fundado no princípio que os pesquisadores devem ter controle sobre suas informações. Para honrar este princípio, temos um forte política de privacidade, que foi projetado para levar em conta as variações locais nas regulamentações de privacidade e nos concentramos na perspectiva do pesquisador ao desenvolver políticas e funcionalidades.
De acordo com nosso princípio fundamental do controle do pesquisador, ORCID os registros só podem ser criados pelos próprios pesquisadores, no ORCID .
Como parte de seu fluxo de trabalho de integração, seus pesquisadores poderão se registrar para um novo ORCID iD ou faça login em seu registro existente, permitindo que você colete seus dados autenticados ORCID eu ia. Por favor, veja nosso Tutoriais da API para obter mais informações.
Adoramos comentários de nossa comunidade, então, por favor, deixe-nos saber se você tem algum comentário sobre os relatórios de membros, entrando em contato conosco em https://support.orcid.org/hc/en-us/requests/new
Se sua organização é uma ORCID membro, então você precisa entrar em contato com o ORCID contato em sua organização que poderá fornecer a você acesso ao ORCID Portal do membro. Se você não conseguir identificar suas organizações ORCID entre em contato com o líder do consórcio ou representante da equipe de engajamento.
Os dados que são usados para produzir os relatórios de membros e integração são atualizados diariamente.
Todas as seções de afiliação usam o mesmo conjunto de metadados na API:
- Nome da organização:* O nome da organização no nível mais alto (por exemplo, “Boston University” em vez de “Boston University School of Medicine”).
- Cidade da organização: * Cidade onde a organização está sediada.
- Região da organização: Região onde a organização está sediada.
- País da organização * o país da organização. Isso deve ser preenchido com o código de país ISO 3166 Alpha-2 de duas letras.
- ID da organização (ROR, GRID, Ringgold** ou LEI):* Um identificador exclusivo para a organização e sua fonte. Recomendamos que o ID da organização-mãe seja usado dentro da afiliação e não da divisão ou departamento.
- Função / Título: O cargo ocupado ou o grau atribuído ou a atribuir.
- Departamento: Qualquer subdivisão da organização principal.
- URL: Um URL para um recurso sobre a afiliação
- Data de início: A data em que o relacionamento entre o pesquisador e a organização começou (pode ser especificado até ano, mês e dia).
- Término: A data em que a relação entre o pesquisador e a organização terminou (pode ser especificada como ano, mês e dia)
- Um identificador externo persistente que descreve a afiliação: Um identificador único para a afirmação de afiliação real
*Indica um campo requerido.
**Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações.
Existem várias seções na parte da biografia de um ORCID registro:
Também conhecido como: Isso pode incluir um primeiro nome abreviado, variantes incluindo iniciais de um ou mais primeiros nomes, nome(s) do meio, nome(s) anterior(es) ou alternativo(s) ou nome(s) em um conjunto de caracteres diferente. Cada nome deve ser adicionado como um único item. Este é um campo de texto livre de até 255 caracteres.
sites: Esta seção inclui uma descrição (opcional) e um URL do site (obrigatório)
País: A seção do país de um ORCID registro permite que pesquisadores e organizações membros adicionem um ou mais países onde realizam pesquisas, ou que são o tópico de suas pesquisas. Os itens da lista de países são provenientes da ISO 3166, o padrão internacional para códigos de país e região.
Identificadores externos (outros IDs): Esta seção só pode ser adicionada por organizações membros. Observe que, embora muitas organizações coletem outros identificadores externos para seus pesquisadores, por exemplo, IDs de autor do Scopus, apenas o emissor desses identificadores pode declará-los com autoridade. Portanto, recomendamos fortemente que sua organização adicione apenas identificadores que seu (s) sistema (s) criou e usa para identificar pesquisadores. Esta seção inclui quatro componentes (* indica um campo obrigatório):
- Tipo de ID *
- Valor de ID *
- Relacionamento de ID *
- URL de identificação
- Função:* O papel do indivíduo no processo de revisão, que pode ser selecionado a partir de: presidente, editor, membro, organizador, revisor
- Identificador de grupo: * O ID do grupo que é usado para fins de agregação — para artigos de periódicos, o identificador padrão é o eISSN, que é preenchido automaticamente por meio de uma integração com o banco de dados ISSN. Observe que, se você precisar atribuir um identificador diferente de um ISSN, precisará crie antes.
- Organização convocatória *: A organização que organizou a revisão - um editor de jornal, organizador de conferências, agência de financiamento, corpo docente, etc.
- Identificador da organização: O identificador persistente da organização convocadora. Atualmente oferecemos suporte ao identificador ROR, Ringgold**, GRID, LEI ou Crossref Funder Registry. Observação: este campo não é obrigatório, mas recomendamos que você publique esses dados se os tiver disponíveis.
- Dados de revisão: * Esses dados se referem à atividade de revisão e não ao que foi revisado
- Tipo: O tipo de atividade de revisão: revisão ou avaliação
- Data: A data em que a revisão foi concluída. Pode ser amplo (2008) ou específico (2010-12-10)
- Identificador de revisão: Um único, de preferência resolvível identificador fornecidas pela fonte da própria revisão. A menos que a avaliação esteja abertamente disponível, recomendamos que ela não contenha dados identificáveis que possam ser rastreados até o assunto da avaliação
- URL de revisão: Um link para uma representação da revisão ou registro de revisão online
- Informações sobre o assunto da revisão: Seja o que for que o revisor avaliou
- Tipo de assunto: O tipo de item que foi revisado, por exemplo, artigo de jornal, artigo de conferência
- Isso inclui o lista de tipos de trabalho E a lista de tipos de concessão ("Concessão", "contrato", "concessão", "prêmio-salário") E pesquisa- "proposta de recurso" E "indefinido"
- Nome do tópico: O nome do item revisado
- Identificador externo do assunto: O identificador único do assunto da revisão, por exemplo, um artigo DOI
- Nome do recipiente do assunto: O nome do objeto do qual o assunto da revisão faz parte, por exemplo, a conferência para a qual o artigo foi revisado
- URL do assunto: O URL do assunto que foi revisado
- Tipo de assunto: O tipo de item que foi revisado, por exemplo, artigo de jornal, artigo de conferência
* Indica campo obrigatório
**Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações.
Existem muitos tipos de recursos de pesquisa, de reagentes de uso único a colaboradores internacionais com instalações dedicadas. ORCID suporta um modelo de alto nível que pode vincular a outros locais para detalhes específicos do domínio.
Existem quatro tipos de recursos de alto nível:
Tipo de recurso | Definição | Exemplos |
Infraestrutura | Uma instalação, edifício ou outro espaço físico usado para realizar pesquisas | Fonte de fragmentação de nêutrons, instalação de animais, enclave de dados, sítio arqueológico, conjunto de telescópios. navios, aviões, fazendas, laboratórios |
Coleção | Um objeto ou grupo de objetos usados para fins de pesquisa; pode ser tangível ou digital | Missão oceânica, campanha de campo, conjuntos de dados ou recursos colaborativos, coleção de livros raros; coleção de museu, coleção de espécimes biológicos |
Equipamentos necessários | Hardware usado para fins de pesquisa | Microscópio, computadores, vidraria, amostras, materiais |
Serviço | Serviços usados para fins de pesquisa | Análise proteômica, serviços de computação, análise de dados, suporte logístico, serviços jurídicos, edição de texto, consultoria especializada ou de equipe |
Além do tipo de recurso, um item de recurso de pesquisa dentro de um ORCID registro contém as seguintes informações. * indica itens necessários
- Título da Proposta / Registro: * Este é o principal campo de exibição para recursos de pesquisa, por exemplo, “Prêmio de feixe de nêutrons” ou “Tempo de feixe e recursos de computação”
- ID da proposta / registro: * Este é o identificador público (DOI, PURL, etc.) da proposta ou solicitação de uso do recurso. O ideal é que esse identificador seja persistente e direcione para uma página de destino pública com informações sobre a proposta ou solicitação, como um banco de dados de prêmios ou registro de usuário de recursos.
- Anfitrião (es) da proposta: * Esta é a organização que recebe e processa propostas ou solicitações de recursos. O Host da Proposta pode ser o mesmo que o Host do Recurso
- ID da Organização Anfitriã da Proposta * Este é o identificador público (um de ROR, GRID, Open Funder ID, LEI) para a organização que gerencia a proposta ou o processo de solicitação
- Recursos):* (até 100)
- Nome do recurso:* - por exemplo, “Fonte de Espalação de Nêutrons”
- ID (s) de recurso: * - de uma lista extensível de tipos de PID aceitáveis (por exemplo, RRID, DOI, URI)
- Tipo de recurso:* - um de 'Infraestruturas', 'Coleções', 'Equipamentos' ou 'Serviços'
- Host (s) de recursos: * Esta é a organização que administra ou opera o Recurso, como um laboratório nacional, agência governamental ou universidade de pesquisa
- ID da organização do host do recurso:* Este é o identificador público (um entre ROR, GRID, Ringgold**, Open Funder ID, LEI) da organização que hospeda o recurso
- URL da proposta: Um link para a proposta
- Data de início da proposta: A data em que o acesso começou
- Data de término da proposta: A data em que o acesso terminou ou terminará
* Indica campo obrigatório
**Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações.
- Título:* O título da obra
- Subtítulo: Uma legenda para o trabalho
- Título traduzido: O título sob o qual a obra aparece em outro idioma, o idioma do título traduzido é registrado como um atributo
- Título da revista: O nome de uma coleção maior à qual o trabalho pertence, como um periódico para artigos de periódicos ou um livro para capítulos de livros. Mesmo que esteja rotulado como título do periódico, ele pode ser usado para outros trabalhos
- Pequena descrição: Uma breve descrição ou resumo do trabalho
- Tipo de citação: O formato em que a citação é fornecida. Este campo é selecionado de uma lista contendo os seguintes valores: APA, BIBTEX, CHICAGO, HARVARD, IEEE, MLA, RIS, UNSPECIFIED, VANCOUVER
- Valor de citação: O conteúdo da citação
- Tipo de trabalho: O tipo de objeto do trabalho. Este campo deve ser selecionado a partir do tipos de trabalho suportados
- Data de publicação: A data em que o trabalho foi publicado. Recomendamos que a data de publicação mais antiga seja usada
- External-id-type: * O tipo de identificador. Este campo deve ser selecionado a partir do identificadores de trabalho suportados
- Valor de id externo: * O próprio identificador
- URL do ID externo: Um url para o qual o identificador resolve
- Relacionamento com id-externo: * Os identificadores que se aplicam apenas ao trabalho que está sendo adicionado seriam marcados como Self. Os identificadores que se aplicam a uma coleção maior à qual este trabalho pertence seriam definidos como Parte de. Os identificadores que se aplicam a versões alternativas da obra seriam definidos como version-of. Os identificadores que se aplicam ao financiamento para o trabalho seriam definidos como financiado por.
- URL de trabalho: Um url com link para o trabalho
- Colaboradores de trabalho: Informações sobre os indivíduos que criaram a obra
- Código de linguagem: A linguagem usada para descrever o trabalho nos campos anteriores
- País: Um país em que o trabalho foi publicado ou associado de outra forma
* Indica campo obrigatório
Todas as seções de afiliação usam o mesmo conjunto de metadados na API:
- Nome da organização:* O nome da organização no nível mais alto (por exemplo, “Boston University”, em vez de “Boston University School of Medicine”).
- Cidade da organização: * Cidade onde a organização está sediada.
- Região da organização: Região onde a organização está sediada.
- País da organização * o país da organização. Isso deve ser preenchido com o código de país ISO 3166 Alpha-2 de duas letras.
- ID da organização (ROR, GRID, Ringgold** ou LEI):* Um identificador exclusivo para a organização e sua fonte. Recomendamos que o ID da organização-mãe seja usado dentro da afiliação e não da divisão ou departamento.
- Função / Título: O cargo ocupado ou o grau atribuído ou a atribuir.
- Departamento: Qualquer subdivisão da organização principal.
- URL: Um URL para um recurso sobre a afiliação
- Data de início: A data em que o relacionamento entre o pesquisador e a organização começou (pode ser especificado até ano, mês e dia).
- Término: A data em que a relação entre o pesquisador e a organização terminou (pode ser especificada como ano, mês e dia)
- Um identificador externo persistente que descreve a afiliação: Um identificador único para a afirmação de afiliação real
*Indica um campo requerido.
**Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações.
- Tipo de financiamento: * O tipo de financiamento concedido. Este campo é selecionado a partir de uma lista contendo os seguintes valores: Prêmio, Contrato, Concessão, Salário-prêmio
- Título de financiamento: * O título do item de financiamento
- Legenda: Um subtítulo para o item de financiamento
- Título traduzido: O título sob o qual o financiamento aparece em outro idioma, o idioma do título traduzido é registrado como um atributo
- Descrição: Uma descrição ou breve resumo do projeto financiado.
- Quantia: O valor do prêmio
- Identificador de financiamento exclusivo: Adicione tantos deles quanto o seu sistema estiver ciente, pois ajuda no agrupamento ORCID Registros.
- Tipo de identificador de financiamento: Use número de concessão, DOI, URI ou id da proposta
- Valor do identificador
- URL do identificador (opcional)
- Relacionamento: self / part-of
Isso indica a relação do item de financiamento com o identificador. Por exemplo, se o item de financiamento for para uma fase de um subsídio de várias partes e o identificador for para o subsídio de várias partes, então o relacionamento seria “parte de”; se o identificador for para a fase individual, então o relacionamento seria “self”.
- Agência financiadora (organização): * Informações sobre a organização que concedeu o financiamento
- Nome da agência
- Endereço (cidade e país)
- Identificador da organização:
- Data de início: A data em que o financiamento começou
- Término: A data em que o financiamento terminou
- Informações dos contribuidores: Informações sobre os indivíduos que receberam o financiamento
- ORCID eu ia: O ORCID iD de cada colaborador do projeto de financiamento; isso deve incluir apenas autenticados ORCID IDs
- Função: A natureza da contribuição do pesquisador
* Indica campo obrigatório
Todas as seções de afiliação usam o mesmo conjunto de metadados na API:
- Nome da organização:* O nome da organização no nível mais alto (por exemplo, “Boston University”, em vez de “Boston University School of Medicine”).
- Cidade da organização: * Cidade onde a organização está sediada.
- Região da organização: Região onde a organização está sediada.
- País da organização * o país da organização. Isso deve ser preenchido com o código de país ISO 3166 Alpha-2 de duas letras.
- ID da organização (ROR, Ringgold**, GRID ou LEI):* Um identificador exclusivo para a organização e sua fonte. Recomendamos que o ID da organização-mãe seja usado dentro da afiliação e não da divisão ou departamento.
- Função / Título: O cargo ocupado ou o grau atribuído ou a atribuir.
- Departamento: Qualquer subdivisão da organização principal.
- URL: Um URL para um recurso sobre a afiliação
- Data de início: A data em que o relacionamento entre o pesquisador e a organização começou (pode ser especificado até ano, mês e dia).
- Término: A data em que a relação entre o pesquisador e a organização terminou (pode ser especificada como ano, mês e dia)
- Um identificador externo persistente que descreve a afiliação: Um identificador único para a afirmação de afiliação real
*Indica um campo requerido.
**Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações.
Todas as seções de afiliação usam o mesmo conjunto de metadados na API:
- Nome da organização:* O nome da organização no nível mais alto (por exemplo, “Boston University”, em vez de “Boston University School of Medicine”).
- Cidade da organização: * Cidade onde a organização está sediada.
- Região da organização: Região onde a organização está sediada.
- País da organização * o país da organização. Isso deve ser preenchido com o código de país ISO 3166 Alpha-2 de duas letras.
- ID da organização (ROR, GRID, RINGGOLD** ou LEI):* Um identificador exclusivo para a organização e sua fonte. Recomendamos que o ID da organização-mãe seja usado dentro da afiliação e não da divisão ou departamento.
- Função / Título: O cargo ocupado ou o grau atribuído ou a atribuir.
- Departamento: Qualquer subdivisão da organização principal.
- URL: Um URL para um recurso sobre a afiliação
- Data de início: A data em que o relacionamento entre o pesquisador e a organização começou (pode ser especificado até ano, mês e dia).
- Término: A data em que a relação entre o pesquisador e a organização terminou (pode ser especificada como ano, mês e dia)
- Um identificador externo persistente que descreve a afiliação: Um identificador único para a afirmação de afiliação real
*Indica um campo requerido.
**Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações.
Obras em ORCID são agrupados com base em seus identificadores e na relação desses identificadores com a obra. Existem quatro tipos de relacionamentos:
- Eu: o identificador refere-se apenas àquela obra e pode ser agrupado com outras obras que possuem o mesmo identificador
- Parte da: a obra faz parte deste identificador e não pode ser agrupada com outras obras
- Versão de: esses identificadores se aplicam a versões alternativas da obra e podem ser agrupados com a própria e com a versão dos identificadores
- Fundado por: esses identificadores se aplicam ao financiamento da obra. Esses identificadores não são usados para trabalhos de agrupamento.
Nossa API fornece suporte para isso no XSD. Cada item possui um atributo de índice de exibição que indica sua classificação dentro de seu grupo. O maior índice de exibição é o item preferido selecionado pelo pesquisador. Itens adicionados por meio da API que não foram classificados pelo pesquisador têm índice de exibição 1 e são usados como fonte preferencial padrão dentro do grupo até serem alterados pelo pesquisador. O índice de exibição também determina a ordem de serviço ao ler o ORCID gravar com a API.
Para obter mais informações sobre agrupamento em ORCID registros, por favor veja nosso artigo de apoio.
An ORCID O registro pode conter informações sobre o trabalho de um pesquisador, afiliações, financiamento, revisão por pares e muito mais.
Itens em ORCID registros podem ser divididos em asserções que conectam o ORCID Detentor de ID com uma atividade ou afiliação. Essas afirmações podem ser adicionadas a um ORCID registro pelo pesquisador que possui o registro, ou por sistemas que o pesquisador concedeu permissão para fazê-lo. Chamamos a entidade que adicionou uma afirmação a um ORCID registre o fonte.
Exemplos
Seguindo nossos princípios de transparência e abertura, acreditamos ser importante poder ver a fonte da afirmação - quem está adicionando essa informação ao registro. Aqui está como fazemos isso:
- Quando um pesquisador (ou seu delegado indivíduo de confiança) adiciona uma afirmação ao seu registro, ORCID registra automaticamente essa pessoa como a fonte
- Quando um sistema aprovado pelo pesquisador adiciona uma afirmação a um registro, ORCID registra automaticamente o proprietário do sistema (um ORCID membro) como a fonte.
Exibimos o nome da fonte na interface do usuário e o disponibilizamos (com seu identificador exclusivo) na API:
No entanto, os fluxos de trabalho de informações de pesquisa podem ser mais complicados do que isso, e a fonte real de uma afirmação pode ser obscurecida involuntariamente por um sistema adicionando um item em nome de uma pessoa ou outro sistema. Para garantir a transparência, precisamos distinguir entre quem fez a conexão entre a pessoa e o item e quem adicionou o item ao registro. Como acima, quem adiciona o item ao ORCID registro é o fonte; quem quer que crie a conexão entre o ORCID iD e o item é o origem da afirmação.
Por exemplo:
- Um pesquisador importa dados para seu ORCID registro de um sistema, como um assistente de pesquisa e link. O pesquisador está fazendo a afirmação conectando seus iD com o item, então eles são o origem da afirmação; enquanto o sistema é a entidade que adiciona a asserção ao ORCID registro - o fonte
- Um pesquisador interage com o Sistema A (o origem da afirmação), que usa serviços fornecidos pelo Sistema B para atualizar ORCID registros, tornando o Sistema B o fonte
Incentivamos nossa comunidade a tomar medidas para preservar e compartilhar informações sobre a origem da afirmação, para que todos possam se beneficiar ao ver a fonte.
Para mais informações, consulte:
ORCID permite a adição de vários tipos de obras. Abaixo está uma lista dos tipos de trabalho que são suportados atualmente, que é amplamente consistente com o Padrão de Saída CASRAI.
Publicações
Tipo de trabalho | Use |
livro | Livros escritos por um único autor ou colaborativamente com base em pesquisas ou achados acadêmicos geralmente derivados de financiamento revisado por pares. |
capítulo de livro | Textos escritos por um único autor ou colaborativamente com base em pesquisas ou descobertas acadêmicas e experiência em um campo. |
revisão do livro | Revisão crítica de obras de ficção ou não ficção, destacando as contribuições para uma arte, campo ou disciplina. |
Entrada do dicionário | Entradas de novas palavras, novos significados de palavras existentes, mudanças na grafia e hifenização por um longo período de tempo e mudanças gramaticais. |
dissertação | Tratado que defende um ponto de vista original resultante da pesquisa: uma exigência para o grau de doutor. Disponível apenas com API v2.x |
tese de dissertação | Um trabalho que é tipicamente baseado em pesquisa original e que dá evidência do domínio do candidato tanto do seu próprio assunto quanto do método acadêmico. Isso só está disponível com API v3.0+ |
entrada de enciclopédia | Entradas de autoria em uma obra de referência ou compêndio com foco em um domínio particular ou em todos os ramos do conhecimento. |
livro editado | Livros editados por um único autor ou colaborativamente para a disseminação de pesquisas ou achados acadêmicos que geralmente resultam de financiamento revisado por pares. |
artigo de jornal | Artigos em publicações revisadas por pares que divulgam os resultados de pesquisas originais e bolsas de estudo. |
edição do jornal | Publicações periódicas destinadas a fomentar o debate intelectual e a investigação. |
artigo de revista | Artigos em publicações temáticas publicadas em intervalos fixos. |
manual | Materiais de cursos e trabalhos produzidos para fins didáticos. |
recurso online | Informações acessíveis apenas na web por meio de métodos técnicos tradicionais |
artigo de boletim informativo | Artigos em publicações destinadas a pesquisadores, tomadores de decisão, profissionais e o público que relatam sobre um projeto de pesquisa ou sobre as atividades de uma cadeira de pesquisa ou de um centro de pesquisa. |
artigo de jornal | Artigos em publicação diária, semanal ou mensal com reportagens sobre notícias e questões sociais dirigidas ao público. |
pré-impressão | Versão de um artigo disponibilizado ao público antes da revisão e publicação formal por pares. Disponível apenas com API v3.0 + |
Denunciar | Relatórios que divulgam os resultados e resultados de um contrato de pesquisa. |
rever | Uma avaliação formal do trabalho de outra pessoa. Isso só está disponível com API v3.0+ |
ferramenta de pesquisa | Série de observações, medidas ou fatos identificados a partir da pesquisa. |
publicação-aluno-supervisionada | Artigos sobre resultados de pesquisas publicados em conjunto ou supervisionados pelo orientador da tese. |
teste | Avaliações que incluem testes elaborados para a seleção geral da universidade, seleção para cursos específicos ou outros fins de avaliação. |
tradução | Traduções de livros e artigos que identificam modificações na edição original, como um prefácio novo ou revisado. |
site do Network Development Group | Locais independentes na web onde vários tipos de informações sobre um tema específico estão disponíveis. |
documento de trabalho | Versões preliminares de artigos que não foram revisados, mas que podem ser compartilhados para comentários. |
Conferência
Tipo de trabalho | Use |
resumo da conferência | Textos de comprimento específico que declaram o assunto a ser discutido em um documento de conferência proposto. |
papel de conferência | Artigos escritos isoladamente ou em colaboração, apresentados em uma conferência acadêmica e publicados nos anais (não em periódicos acadêmicos). |
pôster de conferência | Cartazes exibidos em um ambiente de conferência e transmitindo destaques de pesquisa de maneira eficiente por meio de gráficos atraentes. |
Propriedade intelectual
Tipo de trabalho | Use |
divulgação | Publicações que estabelecem invenções como técnica anterior, evitando, assim, que outros patentem a mesma invenção ou conceito. |
licença | Contratos assinados para explorar um pedaço de IP, como um processo, produto, dados ou software. |
patente | Uma forma de proteção de PI que define o direito exclusivo por lei para inventores e cessionários de fazer uso e explorar suas invenções, produtos ou processos, por um período limitado de tempo. |
copyright registrado | Propriedade registrada de direitos sob um sistema de leis para promover a criação e o acesso a obras artísticas, literárias, musicais, dramáticas e outras obras criativas. |
marca registrada | Marcas como nome, palavra, frase, logotipo, símbolo, design, imagem de um produto ou serviço que indica a fonte e fornece o direito de controlar o uso do identificador. |
Outros
Tipo de trabalho | Use |
anotação | As anotações contêm comentários ou descrições sobre outro recurso. Disponível apenas com API v3.0 + |
performance artística | A coleção de registros de informações que, combinados, representam uma história completa e atualizada de produções artísticas ou performáticas resultantes de, ou relacionadas a, pesquisas ou atividades acadêmicas da pessoa. |
plano de gerenciamento de dados | Uma declaração formal que descreve como os dados de pesquisa serão gerenciados e documentados ao longo de um projeto de pesquisa e os termos relativos ao depósito subsequente dos dados em um repositório de dados para gerenciamento e preservação de longo prazo. Disponível apenas com API v3.0 + |
conjunto de dados | Uma série de observações estruturadas, medidas ou fatos identificados a partir da pesquisa que podem ser armazenados em um meio de banco de dados. |
invenção | Produtos práticos e originais decorrentes da pesquisa. |
palestra-discurso | Uma palestra informativa relacionada à pesquisa entregue a um público. |
objeto físico | Um espécime, amostra ou outro objeto físico usado para fins de pesquisa; um objeto ou substância tridimensional inanimada. Disponível apenas com API v3.0 + |
técnica de pesquisa | Métodos práticos ou habilidades aplicadas a tarefas específicas identificadas como parte da pesquisa. |
Programas | Um programa usado para operar um computador ou outro dispositivo técnico. |
empresa spin-off | Uma empresa criada por uma organização de pesquisa para fazer uso comercial dos resultados e descobertas do projeto de pesquisa. |
padrões e política | O desenvolvimento de uma regra ou princípio que é usado como base para o julgamento. |
padrão técnico | Normas Técnicas (industriais ou não) originadas de projetos de pesquisa em que novos protocolos, métodos ou materiais possam ser desenvolvidos. |
de outros | Qualquer outro tipo de trabalho. |
ORCID suporta o uso de Identificadores ROR, Identificadores GRID e a Crossref Funder Registry identificadores para desambiguar organizações em ORCID Registros.
Para mais informações, consulte Trabalho com identificadores de organização
Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações
Por favor consulte o nosso lista de identificadores suportados para a API V3.0. Ocasionalmente, adicionamos novos tipos a pedido de ORCID membros que gostariam de usá-los ao adicionar itens ao registro.
- Primeiro nome
- Adicional
Funções para API 2.0 de trabalhos
A seguir está a lista de funções de contribuidor com suporte usando API 2.0.- autor
- cessionário
- editor
- cadeira-ou-tradutor
- co-investigador
- co-inventor
- estudante graduado
- outro-inventor
- investigador principal
- pesquisador pós-doutorado
- equipe de suporte
Funções para API 3.0 de trabalhos
Com a API 3.0, você pode adicionar as funções acima, além de funções adicionais CRedIT. A taxonomia CRediT consiste em 14 tipos de contribuição para o trabalho acadêmico, juntamente com diretrizes sobre como essas funções podem ser atribuídas. Abaixo está a lista completa com o valor da UI e o valor dos metadados. O valor dos metadados é o URL de acordo com as recomendações de implementação da NISO 'CRediT deve ser codificado em JATS xml v1.2, descrito por meio deste link: https://jats4r.org/credit-taxonomy.' Apenas o URL será aceito ao adicionar funções por meio da API.Exemplo de metadados do colaborador de trabalho:
https://orcid.org/0000-0001-5109-3700 0000-0001-5109-3700 orcid.org Laure L. Haak first author
Funções para financiamento
- conduzir
- co-líder
- apoiado por
- outra-contribuição
Introduzimos um novo campo gerado pelo sistema, que expressa identificadores externos (DOIs, PMCID, PMID, ArXiv, Bibcode, ISSNs e ISBNs) em um formato normalizado para fins de correspondência e agrupamento. A normalização é feita com base nas regras do tipo de identificador e pode incluir definir todos os caracteres alfa para minúsculas ou transformar espaços, travessões, pontos e outros caracteres que podem ser tratados como equivalentes. Ele também adiciona prefixos e sufixos padrão conforme apropriado. Por exemplo, https://doi.org/10.1/123, 10.1/123 e https://dx.doi.org/10.1/123 todos aparecerão neste campo como https://doi.org/10.1/123. O valor do identificador existente não foi modificado.
Qualquer autor cujo editor usa Crossref para seu registro DOI pode se beneficiar da integração de atualização automática Crossref.
Os editores precisam incluir o autenticado ORCID IDs de seus autores dentro dos metadados enviados ao Crossref no registro do DOI.
O Crossref irá então solicitar permissão do autor por meio de uma notificação para seu ORCID caixa de entrada para atualizar seu ORCID registre com esta publicação e quaisquer novas publicações de qualquer editor.
Para obter mais informações, consulte: https://www.crossref.org/community/orcid/
ORCID fornece um campo de citação de texto livre para que as informações possam ser facilmente inseridas em formato de texto pelos pesquisadores. No entanto, recomendamos fortemente que todos os usuários da API adicionem citações no BibTeX, que pode ser lido por máquina. O venerável formato, apesar de anterior à internet, pode ser transformado no formato desejado por integrações e autores. É suportado pela maioria dos gerenciadores de referência e plataformas de publicação
Para obter mais informações sobre BibTeX, consulte https://www.bibtex.org.
Como um benefício de ORCID associação, as organizações podem perguntar ORCID para suportar tipos de PID adicionais no ORCID Registro. Por exemplo, um membro pode solicitar que adicionemos suporte para os PIDs que eles usam para identificar amostras ou conjuntos de dados em seu banco de dados geológico. Isso permite links entre as amostras e as pessoas que as coletaram. E, como todos os novos tipos de PID que adicionamos devem ser pelo menos resolvíveis e, de preferência, FAIR, esses links são inequívocos, persistentes ao longo do tempo e acionáveis - beneficiando o pesquisador, a organização membro e a comunidade em geral.
Adicionando seu PID!
Como uma organização comunitária, queremos garantir que ORCID suporta os PIDs usados por nossos membros. Nós mantemos um completo lista de identificadores existentes com suporte no registro e convidar ORCID membros para usar esta forma para solicitar PIDs adicionais. Nosso objetivo é responder à sua solicitação o mais rápido possível.
Cada item no ORCID iD recebe um código put que o identifica exclusivamente. Ao ler um registro ou seção inteira, o código put pode ser encontrado como um atributo do item. Quando chamar um item específico em um registro, o código put é usado para identificar o item. Os códigos de colocação são únicos dentro do tipo de item a que se referem. Usando este exemplo, apenas um trabalho no ORCID O registro terá o código put 733535, embora 733535 também possa ser usado como um código put para um item de financiamento ou uma palavra-chave
Total de IDs únicos: o número de pesquisadores que concederam permissão para uma integração pertencente à sua organização. Isso inclui permissões somente leitura e de atualização. Cada pesquisador é contado apenas uma vez, não importa quantas integrações tenham conectado.
Suas integrações: uma lista de integrações para sua organização usando a API de membro com contagens de acompanhamento de IDs conectados e registros atualizados. Também incluiu o nome do sistema de terceiros que está sendo usado para integrar com ORCID onde aplicável.
Novos usuários por ano: um gráfico que mostra os usuários se conectando a cada uma de suas integrações ao longo do tempo.
Os relatórios mais antigos que oferecemos suporte antes de 2022 não estão mais disponíveis para visualização. Se você tiver alguma dúvida sobre os relatórios anteriores, entre em contato [email protegido]
ORCID tem uma seção separada no ORCID registro para registrar informações sobre qualificações, credenciamento, certificados e crachás.
Cada item de qualificação sempre conterá:
- O título de qualificação
- ID da organização do provedor (por exemplo, ID ROR)
- A data em que foi adicionado ao ORCID registro
- Quem adicionou a qualificação (a fonte)
Eles podem conter:
- A data de validade, incluindo uma data de término se a qualificação expirar
- O ID persistente de qualificação, identificando o tipo de qualificação obtida.
- O URL de qualificação, que contém uma descrição legível por humanos do tipo de qualificação obtida.
- O ID persistente da qualificação. Isso deve vincular a uma versão online do certificado de qualificação. Isso pode ser um ID exclusivo existente ou simplesmente um URI.
Registros atualizados com afiliações: Uma métrica que conta quantos IDs foram atualizados por suas integrações com um tipo de item específico, por exemplo, obras, afiliações
Total de afiliações adicionadas: Uma métrica que conta quantos itens de um determinado item foram adicionados
Tipos de afiliações adicionadas: Uma porcentagem de quantos de cada tipo de afiliação foi adicionado, por exemplo, emprego, educação
Identificadores de organização adicionados: Uma tabela que lista os tipos de afiliação e os IDs da organização usados por sua integração ao adicionar afiliações aos registros, junto com uma contagem dos registros atualizados com esse ID da organização.
Total de registros atualizados: O número de pesquisadores que se beneficiaram com atualizações automáticas em seus registros feitas por suas integrações
IDs únicos conectados por ano: Um gráfico mostrando os IDs conectados divididos por ano.
Registros atualizados por ano por integração: O número de pesquisadores que se beneficiaram com atualizações automáticas em seus registros feitas por suas integrações
Total de itens adicionados por ano por integração: um gráfico mostrando o número de itens adicionados por suas integrações todos os anos
Registros atualizados com obras: O número de registros que tiveram pelo menos um trabalho adicionado por uma integração
Total de obras adicionadas: O número total de trabalhos adicionados por suas integrações
Tipos de trabalhos adicionados: Uma porcentagem de quantos de cada tipo de trabalho foi adicionado, por exemplo, Artigo de Jornal, Pré-impressão
Registros atualizados com revisão por pares: O número de registros que tiveram pelo menos uma revisão por pares adicionada por uma integração
Total de revisão por pares adicionada: o número total de revisões por pares adicionadas por suas integrações
Registros atualizados com sites e links sociais: O número de registros que têm pelo menos um site e link social adicionados por uma integração
Registros atualizados com identificadores pessoais: O número de registros que têm pelo menos um identificador pessoal adicionado por uma integração
Registros atualizados com financiamento: O número de registros que têm pelo menos um financiamento adicionado por uma integração
Financiamento total adicionado: O número total de financiamento adicionado por suas integrações
Registros atualizados com recursos de pesquisa: O número de registros que têm pelo menos um recurso de pesquisa adicionado por uma integração
Países de filiação: Um gráfico mostrando os códigos de país nos metadados de afiliação de IDs conectados.
Afiliações atuais: Uma tabela listando afiliações encontradas em todos os iDs com código de país, divididas por ID e tipo de organização. Inclui apenas afiliações atuais, ou seja, aquelas sem uma data de término.
Código do país: Um gráfico que mostra os códigos de país restritos aos metadados biográficos de IDs conectados.
Localização do usuário no último ano: Um gráfico mostrando onde seu usuário estava ao conceder permissão para sua organização via OAuth
Total de registros com domínios: Uma métrica que conta o número total de iDs que possuem um endereço de e-mail terminando em um dos domínios registrados. Caso o registro possua endereço de e-mail com mais de um dos domínios cadastrados eles serão incluídos na contagem mais de uma vez. Se desejar adicionar domínios adicionais, informe-nos.
Registros com domínios registrados: Uma lista de seus domínios de e-mail registrados juntamente com o número de registros usando esse domínio.
Registros por subdomínio: Uma lista de seus subdomínios de e-mail registrados junto com o número de registros usando esse subdomínio
Registros que adicionam domínios de e-mail por ano: Um gráfico que mostra o uso de domínios registrados ao longo do tempo. Os pesquisadores podem ter cadastrado mais de um endereço de e-mail, e este gráfico contabiliza todos os endereços do pesquisador.
Esta seção mostra o número de registros que suas integrações atualizaram
Registros atualizados com afiliações: Uma métrica contando quantos iDs foram atualizados por suas integrações com afiliações.
Total de afiliações adicionadas: uma métrica que conta quantas afiliações foram adicionadas
Tipos de afiliação adicionados: Uma porcentagem de quantos de cada tipo de afiliação foi adicionado, por exemplo, emprego, educação
Identificadores de organização adicionados: Uma tabela que lista os tipos de afiliação e os IDs da organização usados por sua integração ao adicionar afiliações aos registros, junto com uma contagem dos registros atualizados com esse ID da organização.
Registros atualizados com obras: Uma métrica contando quantos iDs foram atualizados por suas integrações com obras
Total de obras adicionadas: Uma métrica contando quantos trabalhos foram adicionados
Tipos de trabalho adicionados: Uma porcentagem de quantos de cada tipo de trabalho foi adicionado, por exemplo, Artigo de Jornal, Pré-impressão
Registros atualizados com revisões por pares: Uma métrica contando quantos registros foram atualizados por suas integrações com uma revisão por pares
Total de revisões de pares adicionadas: Uma métrica contando quantas revisões por pares foram adicionadas
Registros atualizados com financiamento: Uma métrica contando quantos registros foram atualizados por suas integrações com um financiamento
Financiamento total adicionado: uma métrica que conta quantos financiamentos foram adicionados
Registros atualizados com identificador pessoal: Uma métrica contando quantos registros foram atualizados por suas integrações com um identificador pessoal
Registros atualizados com recursos de pesquisa: Uma métrica contando quantos registros foram atualizados por suas integrações com recursos de pesquisa
Registros atualizados com sites e links sociais: Uma métrica contando quantos registros foram atualizados por suas integrações com um site ou link social
Esta seção mostra o número de pesquisadores interagindo com suas integrações.
IDs conectados: o número de pesquisadores que concederam permissão para uma integração pertencente à sua organização. Isso inclui permissões somente leitura e atualização. Cada pesquisador é contado apenas uma vez, não importa quantas integrações tenham se conectado.
IDs conectados: Lista de conectados ORCID IDs incluindo nome do registro.
Registros atualizados com esta integração: O número de pesquisadores que se beneficiaram com atualizações automáticas em seus registros feitas por suas integrações
iDs conectados pela primeira vez: Um gráfico mostrando IDs conectados ao longo do tempo.
Registros atualizados pela primeira vez: Um gráfico mostrando registros atualizados ao longo do tempo. Cada iD é contado uma vez, de acordo com o ano em que foram atualizados pela primeira vez
IDs únicos conectados por ano: um gráfico que mostra os Connected iDs divididos por ano.
Registros únicos atualizados por ano: um gráfico mostrando os registros atualizados divididos por ano.¬¨‚
Esta seção mostra quantos pesquisadores estão vinculados ao país do consórcio. Isso será mais relevante para os consórcios nacionais. Observe que as informações apresentadas podem ou não ter sido adicionadas por membros do consórcio.
País do Consórcio: Código do país do seu consórcio
Total de IDs afiliados ao país: Uma métrica que mostra o número total de IDs no registro que têm o código do país do consórcio na seção de afiliação de seu registro. Inclui todas as afiliações, passadas e presentes
IDs com código do país: Uma métrica que mostra o número total de IDs no registro que têm o código do país do consórcio na seção de biografia de seu registro.
Total de IDs afiliados ao país (atual): uma métrica que mostra o número total de IDs no registro que possuem o código de país do consórcio na seção de afiliação de seu registro. Inclui apenas afiliações atuais, ou seja, aquelas sem data de término.
Afiliações atuais (para todos os IDs com o país):Uma tabela listando afiliações encontradas em todos IDs com código do país, dividido por ID e tipo de organização. Inclui apenas afiliações atuais, ou seja, aquelas sem data de término.
IDs ativos com código de país: Número de registros ativos (cadastrados ou atualizados nos últimos 365 dias) com código de país do consórcio
Esta seção mostra o número de integrações de membros do consórcio de registros de pesquisadores atualizadas. Pode ser usado para entender o quão bem os membros do consórcio estão ajudando seus pesquisadores a manter seus registros atualizados.
Registros únicos atualizados por ano: Um gráfico mostrando os registros atualizados divididos por ano. Os pesquisadores são contabilizados para todos os anos em que foram atualizados por um membro do consórcio.
IDs únicos conectados por ano: um gráfico que mostra os IDs conectados divididos por ano. Os pesquisadores são contados para todos os anos em que concederam permissão.
Registros atualizados por ano por integração: Um gráfico mostrando os registros atualizados por ano e integração dentro de seus consórcios
Esta seção mostra o número de pesquisadores interagindo com integrações de membros de consórcios.
Total de membros do consórcio: O número total de membros em seu consórcio
Integrações totais: O total de integrações em seu consórcio
Integrações ativas: o número de integrações em seus consórcios que atualizaram pelo menos um registro
Total de IDs conectados: O número de pesquisadores que autorizaram a integração de um membro pertencente aos consórcios. Isso inclui permissões somente leitura e de atualização. Cada pesquisador é contado apenas uma vez, não importa quantas integrações tenham conectado
Registros atualizados
Número de pesquisadores que se beneficiaram com atualizações automáticas em seus cadastros feitas por membros de consórcios.
Integrações de membros de consórcios:
Uma lista de integrações registradas pelos membros do consórcio, com contagens de IDs conectados, registros atualizados, qual sistema de provedor de serviços é usado, se aplicável, e se a integração é para o portal do membro (Affiliation Manager)
Novos usuários por ano por integração: um gráfico que mostra os usuários se conectando a cada uma de suas integrações ao longo do tempo.
Esta seção mostra onde os ID's conectados se originam
Países de afiliação atuais: um gráfico que mostra os códigos de país nos metadados de afiliação de IDs conectados.
Afiliações atuais: Uma tabela listando afiliações encontradas em todos os iDs com código de país, divididas por ID e tipo de organização. Inclui apenas afiliações atuais, ou seja, aquelas sem uma data de término.
Localização do usuário: um gráfico mostrando onde seu usuário estava baseado ao conceder permissão à sua organização via OAuth
Código do país: Um gráfico que mostra os códigos de país restritos aos metadados biográficos de IDs conectados.
Registros atualizados com afiliações: Uma métrica contando quantos iDs foram atualizados por integrações de membros de consórcios com uma afiliação
Tipos de afiliação adicionados: Uma porcentagem de quantos de cada tipo de afiliação foram adicionados.
Total de afiliações adicionadas: Uma métrica contando quantas afiliações foram adicionadas por integrações de membros de consórcios
Membros do consórcio adicionando afiliações: Uma lista de quantas afiliações foram adicionadas por integrações de membros de consórcios
Identificadores de organização adicionados:Uma lista de quantos identificadores de organização foram adicionados por integrações de membros de consórcios.
Esta seção mostra quantos pesquisadores se registraram usando o (s) domínio (s) de e-mail nos quais os consórcios se registraram ORCID. Um máximo de cinco endereços de e-mail podem ser registrados.
Domínio de e-mail nacional: O Quê ORCID tem para o domínio de e-mail nacional de seus países
Registros com domínio nacional: Uma contagem de registros que possuem um endereço de e-mail com seu domínio de e-mail nacional
Domínios de e-mail registrados pelos membros: Uma lista de domínios de e-mail registrados pelos membros do seu consórcio
Registros por subdomínio de membro: uma lista de subdomínios que estão conectados aos seus consórcios e quantos ORCID registros estão associados a eles. Observe que esse número de registros pode não corresponder ao número total de registros com seu domínio de e-mail. Isso pode ocorrer porque nem todos os domínios de e-mail registrados contra os membros do seu consórcio terminarão no seu domínio nacional
Registros ativos com domínio nacional: Número de registros ativos (entrado ou registro atualizado nos últimos 365 dias) com domínio de email nacional
Registros adicionando domínio de email por ano: Um gráfico que mostra o número de registros adicionados por domínio de e-mail.
Itens adicionados por ano por integração:Um gráfico mostrando quantos itens foram adicionados discriminados por ano e membro em seu consórcio.
Registros atualizados com obras: O número de registros que tiveram pelo menos um trabalho adicionado por uma integração
Total de obras adicionadas: O número total de trabalhos adicionados por suas integrações
Tipos de trabalho adicionados: Uma porcentagem de quantos de cada tipo de trabalho foi adicionado, por exemplo, Artigo de Jornal, Pré-impressão
Registros atualizados com revisões por pares: O número de registros que tiveram pelo menos uma revisão por pares adicionada por uma integração
Total de revisões de pares adicionadas: O número total de revisões por pares adicionadas por suas integrações
Registros atualizados com financiamento: O número de registros que têm pelo menos um financiamento adicionado por uma integração
Financiamento total adicionado: O número total de financiamento adicionado por suas integrações
Registros atualizados com recursos de pesquisa: O número de registros que têm pelo menos um recurso de pesquisa adicionado por uma integração
Registros atualizados com sites e links sociais:O número de registros que têm pelo menos um site e link social adicionados por uma integração
Registros atualizados com identificadores pessoais: O número de registros que têm pelo menos um identificador pessoal adicionado por uma integração
Você pode solicitar credenciais de API de membro da sandbox para construir e testar seu aplicativo. Essas credenciais permitem que você faça chamadas para a API de membro premium do sandbox para ler, gravar e atualizar ORCID registros. O acesso ao ambiente de teste sandbox está disponível gratuitamente para qualquer pessoa, mesmo se você não for um ORCID organização membro.
Note: Se você estiver usando um ORCID sistema de provedor de serviços certificado que já suporta ORCID, você não precisa se registrar para obter credenciais da API sandbox, a menos que queira experimentar o ORCID funcionalidade de integração dentro do ambiente Sandbox.
O sandbox permite que você crie contas de usuário de teste e desenvolva sua integração sem ter que se preocupar em afetar os dados ao vivo (produção) ORCID Registro. A sandbox se comporta da mesma maneira que a produção ORCID Registro com algumas exceções.
Criação de uma conta de teste
A fim de testar o ORCID API e chamadas de API, como leitura e adição de informações a um ORCID registro, você também precisará criar um teste ORCID gravar na caixa de areia. Isso pode ser feito por meio da interface do usuário, bem como na produção ORCID Registro. Vamos para https://sandbox.orcid.org/register e registre-se para uma conta.
Endereços de e-mail do Mailinator
O servidor sandbox só envia e-mails para Mailinator (@mailinator.com) endereços de e-mail para não enviar spam aos servidores de e-mail involuntariamente. Você não receberá um e-mail de verificação ou notificação de redefinição de senha, a menos que use um endereço @mailinator.com, e a verificação é necessária para fazer edições manuais nos registros do sandbox. Saiba mais sobre suas caixas de entrada públicas gratuitas Aqui. Se você não deseja usar um Mailinator endereço, anote seu nome de usuário e senha (pois você os usará para conceder autorização ao seu aplicativo durante o teste) e entre em contato conosco para solicitar assistência com a verificação.
Mailinator é um serviço de e-mail que possui um serviço público gratuito e um serviço privado pago. Para testar, você pode usar o serviço público totalmente gratuito. Saiba mais sobre seus níveis aqui.
Mailinator é um serviço de terceiros que não é gerenciado ou mantido por ORCID. Recomendamos que você analise como esse serviço funciona e suas limitações antes de usar esses endereços.
As integrações precisam armazenar mais do que apenas ORCID registros. Seu sistema deverá ser capaz de:
- Aceitar e armazenar ORCID IDs: Seu sistema precisará saber o iD que acontecerá no marco da ORCID gravar para exibir o iD e atualizar corretamente. Armazene-o junto com as informações do pesquisador que são retornadas na resposta da troca de tokens. Nossa recomendação é armazenar o URI https completo: https://orcid.org/0000-0001-5727-2427.
- Aceitar e armazenar persistente tokens de acesso e a tokens de atualização: Os tokens de acesso podem ser usados para ler e atualizar registros, bem como indicar que o iD foi autenticado. Os tokens de acesso são válidos por aproximadamente 20 anos ou até que o usuário os revogue. Também recomendamos que você armazene o escopo de token, expiração de token e a tokens de atualização. Os tokens de atualização podem ser usados para criar novos tokens de acesso com escopos iguais ou limitados, se necessário. Armazene os dados do token de acesso junto com as informações do pesquisador.
- Aceitar e armazenar colocar códigos : Cada item que você adiciona ao ORCID O registro será retornado com um código colocado pelo ORCID API. Salve este código put de 6 dígitos junto com o item em seu sistema, é assim que você identificará qual item precisa ser lido, atualizado ou excluído.
- Fornece mensagens de erro e um contato de suporte quando uma interação não ocorre conforme o esperado.
Você precisará preencher o formulário para registrar um aplicativo cliente. Abaixo está uma visão geral rápida dos campos solicitados:
Nome da Organização: Seu ORCID nome da organização membro
Endereço de e-mail de contato principal para credenciais: Usaremos este endereço de e-mail para enviar a você as credenciais em um e-mail criptografado e para entrar em contato com você caso surja alguma dúvida ou erro em sua integração.
E-mail secundário para senha: um endereço de e-mail para o qual podemos enviar sua senha de e-mail criptografada.
Nome do seu cliente: Este será o seu ORCID nome da organização membro. Se você tiver mais de uma integração, anexaremos o aplicativo ao nome.
URL da página inicial do seu aplicativo: Exibido como um link na lista de organizações confiáveis entre os usuários ORCID página de partes confiáveis. Este deve ser um link para sua organização ou para a página principal do seu aplicativo.
Breve descrição de seu aplicativo cliente: Este texto será exibido na tela de autorização com o ícone de ponto de interrogação para seus usuários de integração. É necessária uma breve descrição da sua integração
Redirecionar URIs: Depois que o usuário autorizar seu aplicativo, ele será retornado a um URI que você especificar. Você deve fornecer esses URIs com antecedência ou seus usuários de integração enfrentarão um erro.
- Somente URIs HTTPS são aceitos.
- Os domínios registrados devem corresponder exatamente aos domínios utilizados, incluindo subdomínios.
- Registre todos os URIs de redirecionamento totalmente, sempre que possível.
- São necessários mais de 5 URIs de redirecionamento? Indique isso nas Notas para ORCID equipe.
Notas para ORCID para: Use este campo para permitir ORCID a equipe sabe mais alguma coisa sobre sua solicitação ou sua integração
Há uma série de requisitos que esperamos que todas as integrações de membros atendam. O ORCID a equipe garantirá que esses requisitos tenham sido atendidos como parte do processo de revisão da integração.
- Use OAuth para autenticar ORCID IDs (não permitir que os usuários pesquisem ou digitem ORCID IDs.)
- Apresente a tela de autorização OAuth de acordo com nosso orientações
- Inclua um ORCID botão ou link de marca em seu site para iniciar a autenticação do iD.
- Use HTTPS para URIs de redirecionamento do seu site e assim por diante ORCID Chamadas de API
- Aceite e armazene todos os dados retornados na troca de tokens junto com os dados do usuário em seu sistema
- Use apropriado escopos e a métodos de solicitação (por exemplo, chamadas POST para adicionar novas informações e chamadas PUT para atualizar as informações existentes)
- Exibir publicamente o autenticado ORCID IDs. IDs devem ser exibidos seguindo nosso marca registrada e iD orientações de exibição.
- Não solicitar que os usuários alterem suas configurações de visibilidade para itens em seus ORCID registro para usar sua integração.
Recomendamos que os desenvolvedores testem a API pública no servidor de teste sandbox antes de usar a versão de produção. Abaixo estão as etapas sobre como registrar-se para credenciais de API públicas nos ambientes Sandbox e Produção.
- Faça login na sua ORCID registro:
Servidor de produção: https://orcid.org/signin
Servidor de teste de sandbox: https://sandbox.orcid.org/signin - Clique no seu nome no canto superior direito
- Clique Ferramentas de desenvolvimento da opção do menu
Observação: Para acessar as Ferramentas do desenvolvedor, você deve verificar seu endereço de e-mail. Se você ainda não verificou seu endereço de e-mail, será solicitado que o faça antes de se registrar para obter credenciais de API públicas - Leia e concorde com os 'ORCID Termos de Serviço do Cliente Público
- Clique no botão “Registre-se para ORCID credenciais públicas da API”.
Preenchendo o formulário de detalhes do aplicativo
- Depois de se registrar para obter suas credenciais de API públicas, você será direcionado de volta às Ferramentas do desenvolvedor (https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools).
- Você precisa preencher o formulário de detalhes do aplicativo apresentado para registrar um novo aplicativo.
- Nome: O nome do seu aplicativo. Isso será exibido para os usuários quando eles concederem permissão ao seu aplicativo para obter seus ORCID iD, e será exibido em seu Lista de organizações confiáveis. Recomendamos usar o nome de sua organização ou serviço (por exemplo, o nome de um jornal).
- URL do aplicativo: O site que o usuário pode visitar para saber mais sobre seu aplicativo. Isso também será exibido em seus Lista de organizações confiáveis.
- Descrição da Aplicação: Informações sobre o aplicativo que você está desenvolvendo e como usará as do usuário ORCID eu ia. Isso será exibido para os usuários na tela do OAuth.
Adicionando URIs de redirecionamento
Depois que o usuário autorizar seu aplicativo, ele será retornado a um URI que você especificar. Você deve fornecer esses URIs com antecedência ou seus usuários de integração enfrentarão um erro.
- Insira seu URI de redirecionamento na caixa fornecida
- Se você precisar inserir mais de 1 URI de redirecionamento, clique em 'Adicionar outro URI de redirecionamento'
Observe:
- Preço: URIs HTTPS são aceitos na produção
- Domínios registrados DEVO correspondem exatamente aos domínios usados, incluindo subdomínios
- Registre todos os URIs de redirecionamento totalmente, sempre que possível. Esta é a opção mais segura e a que recomendamos. Para obter mais informações sobre URIs de redirecionamento, consulte nosso Perguntas frequentes sobre URI de redirecionamento
Salvando seu aplicativo
Depois de preencher o formulário de inscrição e adicionar seus URIs de redirecionamento, você pode salvar sua inscrição.
- Clique em 'Salvar meu aplicativo e gerar meu ID de cliente e segredo'
Você será direcionado de volta para a página de ferramentas do desenvolvedor, que agora incluirá suas credenciais de cliente da API pública
Atualizando suas credenciais
Fazer uma alteração nas informações do seu aplicativo é muito simples.
- Edite as informações relevantes e clique em 'Salvar aplicativo'
Use suas credenciais
Agora que você tem suas credenciais, é hora de começar a usar o ORCID API pública!
Observe que podemos transferir suas credenciais para o membro API se você se tornar um ORCID membro no futuro.
Solicitação de organizações membros ORCID Credenciais de API de membro no servidor de produção (ao vivo) ao preencher o Formulário de inscrição do cliente da API do membro de produção. Antes de emitir credenciais de API de membro de produção, o ORCID A equipe de engajamento/líder do consórcio analisará uma demonstração de sua integração no ORCID caixa de areia. Isso nos dá a oportunidade de ver as ótimas integrações que você construiu e oferecer melhorias no fluxo de trabalho, bem como verificar se todas as integrações atendem às nossas melhores práticas e requisitos mínimos para lançamento.
Para fornecer uma demonstração de seu sistema, você precisará configurar uma integração funcional com o ORCID caixa de areia que o ORCID equipe pode visualizar. Existem algumas maneiras de compartilhar sua integração de sandbox de trabalho:
- Recomendado: Demonstração ao vivo: Entre em contato para agendar uma demonstração ao vivo. Forneceremos software de reunião que permite compartilhar sua tela para demonstrar sua integração.
- Site de teste: Se o seu site de desenvolvimento for público, envie-nos o URL junto com credenciais de teste (se necessário) para acessar seu sistema e instruções que descrevem como usar o seu sistema ORCID recursos. Forneça documentação adicional para verificar o que não poderíamos ver do usuário final, por exemplo, a versão da API usada, quais dados são armazenados pelo seu sistema, etc.
- Screencast ou capturas de tela:Envie uma gravação ou um conjunto de capturas de tela com descrições explicando e demonstrando claramente como sua integração funciona em cada etapa, incluindo o que acontece se um usuário negar acesso ou desconectar seu ID. Certifique-se de fornecer documentação adicional para verificar qualquer coisa que não conseguiríamos ver do usuário final, como a versão da API usada e como os dados são armazenados
Assistentes de pesquisa e link são integrações que podem ser usadas para importar itens (principalmente trabalhos) para o ORCID Registro. Eles devem passar por testes entre o integrador e ORCID antes que eles possam ser liberados para o ambiente de registro de produção.
Dependendo de suas respostas às perguntas abaixo, sua integração pode ser um candidato adequado para pesquisa e link — entre em contato conosco para discutir isso antes de começar a desenvolver um assistente de pesquisa e link:
- Qual é o público-alvo do assistente? Por exemplo, autores, revisores ou candidatos a bolsas em nível nacional, disciplinar ou global
- Qual é o tamanho aproximado do público esperado?
- Servirá a uma população atualmente carente de bruxos existentes? Por exemplo, contribuições de pesquisa em um idioma ou disciplina específica, ou que sejam de um novo tipo
- Como você garantirá que o assistente proporcione uma boa experiência do usuário?
- Qual suporte ao usuário você fornecerá?
- Existe - ou existirá - um ORCID apontar pessoa para sua organização, como um gerente de produto, para o assistente?
- Como você vai garantir que ORCID IDs são autenticados?
- Você - ou irá - ingerir e exibir ORCID IDs na sua plataforma?
- A pesquisa de sua plataforma é ativada por iDs?
Por favor consulte o nosso Fluxo de trabalho de pesquisa e link para mais detalhes.
Webhooks permitem que membros premium 'assistam' ORCID registros e ser notificado de quaisquer alterações.
Usando a API e as credenciais do cliente de membro premium, os membros premium podem registrar uma URL de retorno de chamada para cada autenticado ORCID iD que desejam rastrear. O ORCID o detentor do registro não precisa conceder permissão específica à organização para registrar o URL, mas a troca de dados real é baseada nos níveis de privacidade definidos pelo ORCID iD suporte.
Com isso no lugar ORCID notificará esse URL especificado enviando uma solicitação quando houver alterações no ORCID registro.
Para obter / acesso limitado de leitura, você deve pedir permissão ao pesquisador. Você faz isso usando OAuth. Especificamente, "OAuth de 3 pernas".
Para obter mais informações, consulte nosso Tutorial da API: Leia os dados em um ORCID registro
Qualquer pessoa com credenciais de API públicas ou de membro pode receber um / read-public token de acesso. Para obter um token, você faz uma chamada para o ORCID Ponto de extremidade do token da API.
Esse processo geralmente é conhecido como fluxo OAuth de credenciais do cliente ou OAuth de 2 etapas.
Um exemplo de chamada para obter um token de acesso para ler dados públicos na sandbox - substitua os espaços reservados por suas credenciais (certifique-se de remover os colchetes.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public API client ID]
client_secret=[Your public API secret]
grant_type=client_credentials
scope=/read-public
Em seguida, você receberá um token de acesso semelhante ao seguinte. O token retornado é de longa duração (não expira por aproximadamente 20 anos) e pode ser usado várias vezes para recuperar dados públicos de ORCID Registros.
{"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer",
"refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518,
"scope":"/read-public","orcid":null}
Observação: Todos os tokens com o escopo / authenticate agora também têm o escopo / read-public incluído. Se você usar apenas o escopo / authenticate, poderá usar os tokens de acesso armazenados para ler dados públicos sem precisar obter novamente um token de acesso.
Integradores que usam a API membro podem usar o / read-public escopo para ler ORCID registrar resumos.
Ao solicitar permissão para interagir com um ORCID registro do usuário, você especifica um ou mais 'escopos'. Cada escopo permite que você faça certas coisas, como ler o registro ou atualizar uma seção específica.
3 pernas refere-se aos três atores envolvidos na obtenção de permissão de um usuário; ORCID, seu sistema e o próprio usuário.
/autenticar
Este escopo é usado para coletar o ORCID iD e ler informações públicas apenas no registro. Todos os outros escopos de três pernas incluem a permissão de autenticação, portanto, esse escopo pode ser omitido se for solicitado qualquer outro acesso. Este escopo está disponível na API de membros ou pública.
/ read-limited (Member API apenas)
Este escopo é usado para obter acesso para ler itens públicos e de visibilidade limitada em um ORCID registro. Este escopo está disponível apenas na API de membros.
/ atividades / atualização (apenas API de membro)
Este escopo é usado para escrever, atualizar e excluir itens nas seções de afiliação, financiamento, trabalhos, atividades profissionais, recursos de pesquisa e revisão por pares de um ORCID registro. Este escopo está disponível apenas na API de membros.
/ pessoa / atualização (apenas API de membro)
Este escopo é usado para escrever, atualizar e excluir itens nas seções de outros nomes, palavras-chave, países, urls de pesquisador, sites e identificadores pessoais externos do registro. Este escopo está disponível apenas na API de membros.
código aberto
Este escopo é usado por integradores OpenID quando um id_token é necessário. Quando o escopo openid é incluído, o Registro retorna um id_token dentro da resposta do token e concede ao cliente permissão para acessar o endpoint de informações do usuário para aquele usuário. Este escopo está disponível na API pública e membro.
Observe que o escopo 'openid' não começa com '/' como o outro ORCID Escopos de API. Isso ocorre porque o escopo 'openid' não é definido por ORCID, mas em vez disso definido pela especificação OpenID Connect. Por favor, veja nosso Documentação OpenID para obter mais informações.
Múltiplos escopos
Vários escopos podem ser solicitados em uma única interação, listando os escopos no URL de autenticação com um espaço codificado entre cada um, como escopo = / leitura limitada% 20 / atividades / atualização% 20 / pessoa / atualização
Acesso completo
Se você deseja acesso total para ler e editar um registro, inclua três escopos em seu URL de autenticação: / read-limited, / Activities / update e / person / update. No URL, eles apareceriam como escopo = / leitura limitada% 20 / atividades / atualização% 20 / pessoa / atualização
Escopos de duas pernas (credencial do cliente)
Para algumas atividades, você não precisa pedir permissão ao usuário. Escopos OAuth de duas pernas são solicitados diretamente do ORCID API e não exigem que o pesquisador conceda permissão. Tokens com esses escopos são válidos por 20 anos e podem ser reutilizados
/ read-public
Este escopo é usado para ler informações públicas em um único ORCID identificação, procure por ORCID registros ou para ler informações resumidas (somente API para membros). Este escopo está disponível na API Membro ou Pública.
/ webhook
Este escopo permite que um aplicativo cliente registre um webhook em um ORCID registro, a fim de receber notificações quando um registro é atualizado. Este escopo está disponível para premium ORCID apenas membros.
ORCID as integrações usam “OAuth de 3 pernas” para autenticar usuários e solicitar permissão para interagir com seus registros. Qualquer integração pode solicitar permissões de leitura usando a API pública. ORCID os membros podem usar a API de membros para solicitar permissões de atualização. Funciona assim:
- Você cria um link especial
- Quando clicado, o usuário é enviado para ORCID
- ORCID pede ao usuário para fazer login
- ORCID pede ao usuário para conceder permissão ao seu aplicativo
- ORCID envia o usuário de volta ao seu sistema com um código de autorização
- Seu sistema troca esse código por um token de acesso
O URL de autorização personalizado inclui as informações do seu cliente, bem como os 'escopos' que especificam as áreas específicas do registro que você deseja acessar. Após o login, o usuário autoriza a conexão com seu sistema e retorna à sua landing page junto com um código de autorização. Este código é então usado para obter seus ORCID iD junto com um token de acesso válido para os escopos solicitados.
Você cria seu link de autorização especificando o ID do cliente de suas credenciais de API e a página de destino associada (URI de redirecionamento). Você escolhe quais permissões solicitar definindo o parâmetro de escopo.
O exemplo a seguir solicita permissão para ler dados de acesso limitado no ORCID servidor de teste sandbox. No mundo real, você exibe esse link em seu site ou o inclui em um e-mail ao solicitar ao usuário a autenticação e autorização. No entanto, para fins de teste, você pode simplesmente colá-lo em seu navegador. Substitua os dados entre colchetes pelas informações do seu cliente e certifique-se de remover os colchetes!
https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]
Aquele em que o usuário clicou no link e fez login em ORCID e recebem permissões, eles são redirecionados de volta ao seu site, como este:
https://[Your landing page]?code=Q70Y3A
Você deve trocar imediatamente o código de autorização para o ORCID iD e token de acesso. O código de autorização expira após o uso. A solicitação fica assim e não pode ser feito em um navegador da web, deve ser feito pelo seu servidor.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
HEADER: Content-Type: application/x-www-form-urlencoded
METHOD: POST
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
grant_type=authorization_code
code=Six-digit code
redirect_uri=[Your landing page]
ORCID irá então devolver o autenticado do pesquisador ORCID iD e um token de acesso no formato JSON:
{"access_token":"f5af9f51-07e6-4332-8f1a-c0c11c1e3728","token_type":"bearer",
"refresh_token":"f725f747-3a65-49f6-a231-3e8944ce464d","expires_in":631138518,
"scope":"/read-limited","name":"Sofia Garcia","orcid":"0000-0001-2345-6789"}
Os tokens de acesso têm longa duração por padrão e expiram 20 anos após a emissão. O token pode ser usado várias vezes antes de expirar.
Use o token de acesso
Tokens de acesso de três etapas estão vinculados a ORCID registro. Para usá-los, você os inclui nas solicitações de API feitas para ler ou atualizar esse registro.
Utilizadores podem alterar seu idioma de exibição por conta própria a qualquer momento. As seguintes configurações de idioma estão disponíveis:
Língua | Code |
عربى (árabe) | ar |
čeština (Tcheco) | cs |
Inglês | en |
Español (Spanish) | es |
Français (francês) | fr |
Deutsch (Alemão) | de |
Italiano (italiano) | it |
日本語 (japonês) | ja |
한국어 (coreano) | ko |
Polski (polonês) | pl |
Português (Português) | pt |
Русский (russo) | ru |
Türkçe (turco) | tr |
简体 中文 (chinês simplificado) | zh_CN |
繁體 中文 (chinês tradicional) | zh_TW |
Se estiver preocupado com o fato de vários usuários estarem na mesma máquina e não desconectando entre as sessões, você pode forçá-los a se reautenticar durante o processo OAuth. Simplesmente inclua prompt=login
na solicitação OAuth. Você também pode definir um max_age em segundos para forçar os usuários a se autenticarem novamente se a sessão ultrapassar um determinado período. Veja nosso Documentação do OpenID Connect para mais detalhes.
OAuth implícito é uma versão mais leve do OAuth projetada para ser usada por sistemas que não possuem ou não desejam usar componentes do lado do servidor. OAuth implícito pode ser implementado inteiramente no navegador usando apenas javascript. Está disponível para associados e não associados e funciona assim:
- Você cria um link especial
- Quando clicado, o usuário é enviado para ORCID
- ORCID pede ao usuário para assinar i
- ORCID pede ao usuário para conceder permissão ao seu aplicativo
- ORCID envia o usuário de volta ao seu sistema com seu ORCID iD, um token de acesso e um token de identificação.
- Seu sistema extrai e armazena os autenticados ORCID iD da resposta.
Por razões de segurança, ao usar OAuth implícito, ORCID não retornará tokens de acesso com permissões de atualização.
Fluxo implícito
O fluxo implícito é projetado para que os clientes não precisem usar sua chave secreta para iniciar ORCID entrar. A segurança é reforçada ao restringir os clientes aos seus redirect_urls registrados. Este nível mais baixo de segurança significa que ORCID suporta apenas os escopos / authenticate e openid ao usar o fluxo implícito. Os tokens também têm vida curta, com uma vida útil de 10 minutos. Este fluxo é recomendado para aplicativos do lado do cliente que não têm acesso a um servidor de back-end, por exemplo, aplicativos de telefone ou aplicativos da web javascript de página única.
https://localhost/#access_token=24c11342-f5da-4cf9-94a4-f8a72a30da00&token_type=bearer&expires_in=599&tokenVersion=1&persistent=false&id_token=eyJraWQiOiJxYS1vcmNpZC1vcmctcjlhZmw3cWY2aG2c5bmdzenU1bnQ3Z3pmMGVhNmkiLCJhbGciOiJSUzI1NiJ9.eyJhdF9oYXNoIjoiMW52bXZBbVdwaVd0Z3ZKZW1DQmVYUSIsImF1ZCI6IkFQUC02TEtJSjNJNUIxQzRZSVFQIiwic3ViIjoiMDAwMC0wMDAyLTUwNjItMjIwOSIsImF1dGhfdGltZSI6MTUwNTk4Nzg2MiwiaXNzIjoiaHR0cHM6XC9cL29yY2lkLm9yZyIsIm5hbWUiOiJNciBDcmVkaXQgTmFtZSIsImV4cCI6MTUwNTk4ODQ2MywiZ2l2ZW5fbmFtZSI6IlRvbSIsImlhdCI6MTUwNTk4Nzg2Mywibm9uY2UiOiJ3aGF0ZXZlciIsImZhbWlseV9uYW1lIjoiRGVtIiwianRpIjoiY2U0YzlmNWUtNTBkNC00ZjhiLTliYzItMmViMTI0ZDVkNmNhIn0.hhhts2-4-ibjXPW6wEsFRaNqV_A-vTz2JFloYn7mS1jzQt3xuHiSaSIiXg3rpnt1RojF_yhcvE9Xe4SOtYimxxVycpjcm8yT_-7lUSrc46UCt9qW6gV7L7KQyKDjNl23wVwIifpRD2JSnx6WbuC0GhAxB5-2ynj6EbeEEcYjAy2tNwG-wcVlnfJLyddYDe8AI_RFhq7HrY4OByA91hiYvHzZ8VzoRW1s4CTCFurA7DoyQfCbeSxdfBuDQbjAzXuZB5-jD1k3WnjqVHrof1LHEPTFV4GQV-pDRmkUwspsPYxsJyKpKWSG_ONk57E_Ba--RqEcE1ZNNDUYHXAtiRnM3w
veja nossa documentação técnica para obter mais informações.
Se um token de acesso ativo já existir com os mesmos escopos que suas solicitações de URL de autorização OAuth e o usuário estiver conectado ao seu ORCID registro, eles não serão solicitados a conceder autorização novamente. Em vez disso, eles serão levados diretamente para o URI de redirecionamento. Se você quiser exigir que um usuário conceda autorização sempre que se conectar, use o forçar método de saída
Qualquer um ou todos os parâmetros podem ser usados:
Parâmetro | Campo | Notas |
recebem nomes | Nome dado | O primeiro nome campo será preenchido no formulário de inscrição se um endereço de e-mail especificado ou ORCID iD não corresponde ao de um ativo ORCID registro. |
sobrenomes | Sobrenome | O Sobrenome campo será preenchido no formulário de inscrição se o endereço de e-mail especificado ou ORCID iD não corresponde ao de um ativo ORCID registro. |
O o email/ORCID iD campo será preenchido no formulário de login se o endereço de e-mail especificado for encontrado em nosso sistema e não for válido ORCID iD é especificado. email campo será preenchido no formulário de inscrição se o endereço de e-mail especificado for encontrado em nosso sistema e não for válido ORCID iD é especificado. O endereço de e-mail deve ser URL codificado, incluindo a alteração de “@” para “% 40”. Se você conhece o usuário ORCID iD e endereço de e-mail, sugerimos só fornecendo o ORCID iD no parâmetro orcid. | ||
orcídio | ORCID iD | O o email/ORCID iD campo será preenchido no formulário de login se o especificado ORCID iD é encontrado em nosso sistema. formulário de inscrição caso contrário, será exibido se o especificado ORCID iD não é encontrado em nosso sistema. ORCID iD deve estar no Formato de 16 dígitos do iD URI. |
Um exemplo de URL com esses parâmetros é
https://sandbox.orcid.org/oauth/authorize?client_id=APP-NPXKK6HFN6TJ4YYIn&response_type=coden&scope=/authenticaten&redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplaygroundn&family_names=Finn&given_names=Huckleberry&email=huckle%40mailinator.com
OpenID Connect 1.0 é uma camada de identidade simples sobre o protocolo OAuth 2.0. Ele complementa os fluxos de autenticação OAuth existentes e fornece informações sobre os usuários aos clientes de uma maneira bem descrita.
OpenID connect é uma forma padronizada de implementar OAuth e compartilhar informações sobre usuários autenticados. Agora será possível configurar os serviços a serem usados ORCID “pronto para uso” junto com outros provedores de conexão OpenID compatíveis com os padrões. O OpenID Connect também fornece tokens de ID compartilháveis, que são objetos assinados que podem provar que um usuário foi autenticado usando ORCID em um momento específico. Esses tokens podem ser usados por elementos da interface do usuário para manter as sessões do usuário.
ORCID suporta o perfil de conformidade do provedor OpenID básico, que é uma extensão do fluxo de código de autorização OAuth. ORCID também suporta o fluxo de token implícito para os escopos “/ authenticate” e “openid”.
Isto significa que ORCID:
- Incorpora tokens de ID assinados em respostas de token para códigos de autorização gerados com o escopo 'openid'
- Suporta o fluxo implícito ao usar 'token' ou 'token id_token' response_types e o escopo 'openid'.
- Suporta os parâmetros 'prompt', 'nonce' e 'max_age' para solicitações de autorização que incluem o escopo 'openid'.
- Suporta descoberta de Openid Connect e pontos de extremidade userinfo
- Suporta o campo 'amr' para integradores que usam a API membro para solicitações de autorização que incluem o escopo 'openid'. Isso pode ser usado para descobrir se um usuário foi autenticado usando a autenticação de dois fatores.
Iniciar uma autenticação OpenID Connect funciona da mesma maneira que uma autenticação OAuth regular. Tudo o que é necessário é que o cliente solicite o escopo 'openid'. Se você estiver usando o escopo / authenticate, substitua-o por openid, visto que authenticate e openid têm a mesma autorização, apenas um ou o outro deve ser usado. Se você estiver usando qualquer outro escopo, adicione openid à lista de escopos solicitados. Quando o escopo openid é incluído, o Registro retorna um id_token dentro da resposta do token e concede ao cliente permissão para acessar o endpoint de informações do usuário para aquele usuário.
observe que o escopo 'openid' não começa com um '/' como o outro ORCID Escopos de API. Isso ocorre porque o escopo 'openid' não é definido por ORCID, mas em vez disso definido pela especificação OpenID Connect.
veja nossa documentação técnica para obter mais informações.
O que são URIs de redirecionamento e como eles são usados?
Os URIs de redirecionamento são usados pelo nosso serviço de autenticação OAuth como medida de segurança. ORCID enviará apenas usuários autenticados para URIs registrados pelo cliente solicitando autenticação. Isso impede que os serviços representem uns aos outros.
Por favor, note que apenas URIs HTTPS são aceitos na produção. Você pode testar usando HTTP URIs, mas precisará se registrar URIs HTTPS quando você solicita credenciais de API de membro de produção.
Como combinamos URIs de redirecionamento?
- Você DEVE registrar subdomínios como URIs separados. https://anythingelse.thirdparty.com não funcionará.
- O registro completo de todos os URIs de redirecionamento, incluindo o caminho, é incentivado, é o que a maioria dos terceiros faz e é a opção mais segura.
- Se o aplicativo cliente estiver registrado com um uri de redirecionamento que seja apenas o nome do host, qualquer uri de redirecionamento nesse host poderá ser usado. Assim, por exemplo, se o seguinte uri de redirecionamento estiver registrado: https://thirdparty.com então todos os seguintes redirect_uris funcionarão:
- https://thirdparty.com/oauth/callback1
- https://thirdparty.com/callback2
- https://thirdparty.com/anything-else-as-long-as-the-host-is-the-same
No entanto, https://anythingelse.thirdparty.com não funciona. Vocês DEVO registrar subdomínios como URIs separados.
O que acontece se meu URI de redirecionamento estiver incorreto?
Usuários enviados para autenticação em ORCID com URIs de redirecionamento incorretos verá uma mensagem de erro semelhante a esta:
Gerenciando URIs de redirecionamento para membros
Se você estiver usando a API de membro e precisar de alterações em seus URIs de redirecionamento, entre em contato com nossa equipe de engajamento
Gerenciando URIs de redirecionamento para clientes públicos
Se você estiver usando a API pública, precisará seguir as etapas abaixo para atualizar sua lista de URIs de redirecionamento associados ao seu ORCID ID do cliente de API pública. Você pode fazer isso seguindo os passos abaixo:
- Entre no seu ORCID registro
- Clique no seu nome no canto direito
- Selecione as ferramentas do desenvolvedor
- Clique no lápis de edição ao lado do nome do cliente
- Edite um URI de redirecionamento existente ou clique em 'Adicionar outro URI de redirecionamento' edite um existente
- Depois de fazer suas alterações, você precisa clicar no ícone salvar
Apenas URIs HTTPS são aceitos na produção. Você pode testar usando URIs http, mas precisará registrar URIs HTTPS ao solicitar credenciais de API de membro de produção.
ORCID permite que os usuários habilitem Autenticação de dois fatores (2FA) em seu ORCID conta. 2FA é uma verificação de segurança secundária feita durante o processo de login. Ele fornece uma confirmação adicional de que o usuário é realmente a pessoa que faz login em um ORCID conta. Para obter mais informações sobre como isso pode ser configurado para os usuários, consulte nosso Artigo da KB.
OpenID conectar integradores usando a API membro pode verificar se o usuário fez login em seu ORCID conta com 2FA habilitado como parte do processo OAuth. Isso pode permitir que integradores membros concedam acesso a seus pesquisadores a sistemas de segurança mais elevados.
IDs de organizações registradas – Esta seção mostra os IDs da organização que foram usados para gerar os dados no relatório. Estes são os IDs que registramos em relação ao seu ORCID adesão.
Número de registros afiliados – O número total de ORCID registros que têm uma afiliação pública (emprego, educação, qualificações, filiação, serviços, cargos convidados e distinções) dentro do registro para sua organização. Observe que pode haver mais que estejam dentro do registro que não tenham um ID de organização anexado ou que não tenham a configuração de visibilidade de 'Todos'
Número de registros com uma afiliação atual – O número total de ORCID registros que têm uma afiliação pública atual dentro do registro para sua organização. Uma afiliação atual é uma afiliação que não tem uma data de término preenchida. Observe que pode haver mais que estão dentro do registro que não têm um ID de organização anexado ou que não têm a configuração de visibilidade de 'Todos'
Número de registros com uma afiliação de emprego atual – O número total de ORCID registros que têm uma afiliação de emprego público atual dentro do registro para sua organização. Uma afiliação atual é uma afiliação que não tem uma data de término preenchida. Observe que pode haver mais que estão dentro do registro que não têm um ID de organização anexado ou que não têm a configuração de visibilidade de 'Todos'
Total de Afiliações – O número total de afiliações públicas dentro do registro para sua organização. Isso inclui afiliações atuais e passadas. Observe que pode haver mais que estejam dentro do registro que não tenham um ID de organização anexado ou que não tenham a configuração de visibilidade de 'Todos'
Afiliações criadas ao longo do tempo – Um gráfico que mostra o número de afiliações que foram adicionadas ao registro ao longo do tempo. O gráfico é dividido por afiliações que sua organização adicionou e as afiliações que foram adicionadas manualmente por seus pesquisadores
Afiliações criadas ao longo do tempo por tipo – Um gráfico que mostra os tipos de afiliações que foram adicionadas ao longo do tempo.
Afiliações criadas ao longo do tempo por ORG ID – Um gráfico que mostra o número de afiliações adicionadas por ID ORG ao longo do tempo.
ORCID fornece um simples Widget Java Script que pode ser usado para obter autenticado ORCID IDs usando OAuth com OpenID Connect.
Observe que o widget usa OAuth implícito, portanto, não coleta nenhuma permissão de gravação. Isso significa que não é adequado para integrações de membros que desejam atualizar registros. Por favor, veja nosso tutorial para Adicionar e atualizar dados em ORCID Registros.
Condizente com nosso compromisso com o controle do pesquisador de seus ORCID registro, o detentor do registro pode optar por revogar qualquer token de acesso a qualquer momento, excluindo-o das permissões no Organização Confiáveln lista em sua página de partes confiáveis.
A partir de 2018, os pesquisadores só podem conceder tokens de acesso de longa duração, que duram 20 anos, a menos que o usuário revogue a permissão.
Publicamente afiliado ORCID Registros - Uma lista de ORCID registros que tenham uma afiliação pública à sua organização. As afiliações públicas são aquelas cuja visibilidade é definida como “todos” no registro. A lista contém os ORCID ID, nome próprio, nome de família e nome de crédito
Atualmente empregado publicamente ORCID GRAVAÇÕES - Uma lista de ORCID registros que tenham uma afiliação de emprego público à sua organização. As afiliações públicas são aquelas cuja visibilidade é definida como “todos” no registro. A lista contém os ORCID ID, nome próprio, sobrenome e data de início da afiliação
Afiliações públicas com dados de afiliação– Uma lista das afiliações públicas à sua organização. A lista inclui ORCID ID, nome próprio, sobrenome, tipo, título, departamento, datas de início e término, data adicionada ao ORCID, data da última modificação da afiliação, tipo de ID da organização e valor do ID da organização.
Todas as seções de afiliação usam o mesmo conjunto de metadados na API:
- Nome da organização:* O nome da organização no nível mais alto (por exemplo, “Boston University” em vez de “Boston University School of Medicine”).
- Cidade da organização: * Cidade onde a organização está sediada.
- Região da organização: Região onde a organização está sediada.
- País da organização * o país da organização. Isso deve ser preenchido com o código de país ISO 3166 Alpha-2 de duas letras.
- ID da organização (ROR, GRID, Ringgold** ou LEI):* Um identificador exclusivo para a organização e sua fonte. Recomendamos que o ID da organização-mãe seja usado dentro da afiliação e não da divisão ou departamento.
- Função / Título: O cargo ocupado ou o grau atribuído ou a atribuir.
- Departamento: Qualquer subdivisão da organização principal.
- URL: Um URL para um recurso sobre a afiliação
- Data de início: A data em que o relacionamento entre o pesquisador e a organização começou (pode ser especificado até ano, mês e dia).
- Término: A data em que a relação entre o pesquisador e a organização terminou (pode ser especificada como ano, mês e dia)
- Um identificador externo persistente que descreve a afiliação: Um identificador único para a afirmação de afiliação real
*Indica um campo requerido.
**Embora os identificadores Ringgold ainda existam dentro do ORCID registro, a partir de 1º de agosto de 2023, ORCID não receberá mais atualizações do banco de dados de identificadores de organização RINGGOLD usado por nosso Registro, nem poderemos processar ou usar IDs RINGGOLD criados após essa data. Veja nosso Perguntas frequentes para mais informações.
Documentação técnica
Um tutorial mais detalhado pode ser encontrado aqui.