ORCID sistemlerinizin sunucuya bağlanmasına izin veren çeşitli API'ler sunar. ORCID okuma ve yazma dahil olmak üzere kayıt defteri ORCID kayıtlar. Bazı API işlevleri herkes tarafından ücretsiz olarak kullanılabilir (Genel API); diğerleri yalnızca kullanılabilir ORCID üye kuruluşlar (Üye ve Premium Üye API'si).
Korumalı alan test sunucumuzda herkes API'yi test etmekte özgürdür kullanan tüm kuruluşları teşvik ediyoruz. ORCID – üyeler ve üye olmayanlar – bize katılmak için API Kullanıcıları Grubu, soru sorabileceğiniz ve yeni teknik gelişmeler hakkında bilgi edinebileceğiniz.
SSS'leri burada arayın:
temeller
Öğeler (işler, istihdam, finansman, akran değerlendirmesi vb.) ORCID manuel olarak veya kullanarak kaydedin ORCID üye API'si. Kaydınızı güncellemek isteyen bir kişiyseniz, Bununla ilgili yardım bölümü burada. Bir üyeye öğe eklemek istiyorsanız ORCID kaydetmek için aşağıdakilere ihtiyacınız olacak:
- araştırmacıların izni
- Üye API kimlik bilgileri
- Ya:
- ile entegre olan bir satıcı sistemidir. ORCID Üye API'sı
- ile entegre olan kendi sisteminizdir. ORCID Üye API'sı
Kayıt öğelerine yönelik API'yi kullanan üyelere yönelik eksiksiz bir kılavuz için aşağıdaki API eğitim bağlantımıza göz atın:
Sosyal bileşeni desteklemek için bir araç seti sunuyoruz. Sosyal Yardım Kaynakları entegrasyonunuzu desteklemek için bir kampanya geliştirmenize yardımcı olmak ve araştırmacılarınızla iletişim kurmak için:
- Ne ORCID olduğunu.
- Sisteminizin kimlikleri neden topladığı ve kayıtlarını güncellemek gibi görevleri nasıl gerçekleştireceği.
- Araştırmacılarınız neden bir ORCID iD ve kimliklerini sisteminize bağlama.
- Ne kadar ORCID daha geniş, küresel araştırma topluluğuna fayda sağlar.
Topluluktan gelen geri bildirimlere dayalı olarak bu kaynak "kütüphanesini" sürekli olarak oluşturacağız. Görmek isteyebileceğiniz bir şey için bir fikriniz varsa, lütfen bizimle iletişime geçmekten çekinmeyin.
Bütünleştirme ORCID sisteminize kuruluşunuzun kimliği doğrulanmış bilgiler toplamasına olanak tanır ORCID iD'leri seçin ve bunları kendi verilerinize ekleyin. Aynı zamanda araştırmacı, kuruluşa kendi aralarında okuma ve yazma izni verir. ORCID kayıt.
Bu işi gerçekleştirmek için kuruluşlar ZORUNLU elde etmek doğrulanmış ORCID kimlikler ile ORCID OAuth API'si. Bu, bir ORCID Sistemlerinde tıklandığında kullanıcıdan oturum açmasını isteyen markalı düğme veya bağlantı ORCID kayıt.
Oturum açtıktan sonra kullanıcıdan sisteme erişime izin vermesi istenecektir. ORCID iD
Kullanıcının ORCID iD ve üzerinde isim ORCID kayıt (görünürlük ayarlarına bağlı olarak) bu sürecin bir parçası olarak kuruluşa iade edilir. Sistem daha sonra ek verileri talep edebilir. ORCID API.
Kimliği doğrulanmış API'leri toplamak için yukarıda açıklanan iş akışı her ikisinde de mevcuttur ORCIDgenel ve üye API'leri. İlki, ticari olmayan hizmetler tarafından ücretsiz olarak kullanılabilir.
Bir kullanıcının hesabına veri eklemek veya güncellemek için izin alma süreci ORCID kayıt, bölümümüzde açıklandığı gibi OAuth'u kullanır. 3 Aşamalı OAuth SSS. Sadece ORCID üyeler, güncelleme izinlerini istemek için Üye API'sini kullanabilir. Basit bir ifadeyle şöyle çalışır:
- Yerel sisteminiz özel bir bağlantı oluşturur
- Tıklandığında, kullanıcı şu adrese gönderilir: ORCID, oturum açar ve izin verir
- ORCID kullanıcıyı bir 'yetki kodu' ile sisteminize geri gönderir
- Sisteminiz bu kodu bir 'erişim belirteci' ile değiştirir.
- Erişim belirteci, kullanıcının kaydını güncellemenizi sağlar
ORCID Bireylerin araştırma, bilim ve yenilik faaliyetlerine katılırken kullanmaları için benzersiz, kalıcı bir tanımlayıcı sağlayarak araştırmacılar, onların katkıları ve bağlı oldukları kuruluşlar arasında şeffaf ve güvenilir bağlantılar sağlamaya çalışır. Doğru olmasını sağlamak ORCID iD Doğru araştırmacıyla ilişkilendirilmesi, araştırmanın güvenilirliğini oluşturmada kritik bir adımdır. ORCID veri kümesi ve daha geniş bilimsel iletişim ekosistemi. Bu yüzden, ORCID manuel olarak toplanmasına veya girilmesine izin vermez ORCID Toplanmanın mümkün olduğu herhangi bir iş akışındaki kimlikler ORCID Kimlikler doğrudan rekor sahiplerinin kendilerinden.
Araştırmacılar çalışmalarını kolayca ve güvenli bir şekilde paylaşabilirler. ORCID etkileşime girdikleri sistemlere sahip olduklarını kanıtlayan kimlikler ORCID İD. Bu sistemler daha sonra araştırmacı faaliyetleri hakkındaki bilgileri diğer sistemlerle paylaşabilir ve bu da araştırmacı faaliyetleri hakkında doğrulanmış ve güvenilir iddialar zinciri oluşturur. Nihai sonuç, doğru kişinin geniş bir yelpazedeki bilimsel bilgi iş akışlarında doğru faaliyetlerle ilişkilendirilmesidir.
Daha fazla bilgi için, bkz: https://info.orcid.org/collecting-and-sharing-orcid-ids/
Doğrulanmış bilgileri kullanıcılarına bağlayarak kullanıcılarınız için hayatı kolaylaştırmaya yardımcı olabilirsiniz. ORCID kayıtlar. Ayrıca akademik iletişimde güven oluşturmaya yardımcı olacaksınız ve bu verileri güncel tutarak kullanıcılarınız için raporlama yükünü azaltabilir ve veri kalitesini artırabilirsiniz.
ORCID Araştırma Kuruluşları için
Araştırmacılarınız için kalıcı tanımlayıcı olarak kullanılmasına ek olarak, ORCID kurumunuzun adının araştırma sistemlerinde nasıl kullanıldığını kontrol etmenize yardımcı olabilir. Diğer kalıcı tanımlayıcılarla birlikte ORCID kurumunuzla personel, fakülte ve öğrenci bağlantılarınızı yetkili bir şekilde beyan etmenizi sağlar. Ayrıca kullanabilirsin ORCID Araştırma faaliyetleri hakkında gerçek zamanlı bildirimler almak, formları otomatik güncellemek ve mezunlarınızın kariyerlerini takip etmek için API'ler.
ORCID Fon Kuruluşları için
gömerek ORCID Finansman iş akışlarınızdaki iD'ler sayesinde, hibe alanlar ile finansman programlarınızı güvenilir bir şekilde birbirine bağlayabilir ve herkesin zamandan tasarruf etmesini sağlayabilir ve bilgilerin manuel olarak girilmesinden kaynaklanan hataları azaltabilirsiniz. kullanma ORCID sistemlerinizde, bireyler ve onlara verdiğiniz hibeler arasındaki bağlantıları öne sürerek güvenilir bir araştırma bilgi altyapısı oluşturmada üzerinize düşeni yapabilirsiniz.
ORCID Yayıncılar için
Araştırmacılar, bilimsel ve araştırma yayıncılarının yaptığı her şeyin merkezinde yer alır. Doğru yazar ve hakem bilgisi, indeksleme, arama ve keşif, yayın izleme, finansman ve kaynak kullanımı ilişkilendirme ve akran değerlendirmesini desteklemek için hayati önem taşır.
ORCID yazarlarınızın ve hakemlerinizin katkılarıyla güvenilir bir şekilde bağlantı kurmasını ve kaynaklarından bilgi paylaşmasını sağlayan bir bilgi merkezi görevi görür. ORCID yayınlama sistemlerinizle etkileşime girdikçe kaydedin. Kitaplar, dergiler, veri kümeleri, kompozisyonlar, sunumlar, kodlar veya diğer çeşitli çalışmalar için yayın sürecinde tüm yazarlarınız ve hakemleriniz için kimlik toplamak, bilgilerin kolayca paylaşılmasına olanak tanır, araştırmacıların paylaşmak için izin vermesini sağlar, araştırmacılara zamandan ve zahmetten tasarruf sağlar, hata riskini azaltır ve daha da önemlisi, araştırmacıların yaptıkları önemli iş için hak ettikleri krediyi almalarını sağlar.
Üye kuruluşlar talebi ORCID Üretim (canlı) sunucusundaki Üye API kimlik bilgilerini tamamlayarak Üretim Üyesi API istemcisi başvuru formu. Üretim Üyesi API kimlik bilgilerini vermeden önce, ORCID Katılım ekibi/Konsorsiya Lideri entegrasyonunuzun bir demosunu inceleyecektir. ORCID kum havuzu. Bu bize, oluşturduğunuz harika entegrasyonları görme ve iş akışı iyileştirmeleri sunma şansı verir, ayrıca tüm entegrasyonların en iyi uygulamalarımızı ve lansman için minimum gereksinimleri karşılayıp karşılamadığını kontrol etme şansı verir.
Sisteminizin bir demosunu sağlamak için, sistemle çalışan bir entegrasyon kurmanız gerekir. ORCID kum havuzu ORCID ekip önizleme yapabilir. Çalışan sanal alan entegrasyonunuzu paylaşmanın birkaç yolu vardır:
- Önerilen: Canlı demo: Canlı bir gösteri planlamak için bizimle iletişime geçin. Entegrasyonunuzu tanıtmanız için ekranınızı paylaşmanıza olanak tanıyan toplantı yazılımı sağlayacağız.
- Test sitesi: Geliştirme siteniz herkese açıksa, bize URL'yi gönder sisteminize erişmek için test kimlik bilgileri (gerekirse) ve sisteminizin nasıl kullanılacağını açıklayan talimatlar ile birlikte ORCID özellikler. Kullanıcı tarafında göremediğimiz şeyleri doğrulamak için ek belgeler sağlayın, örneğin kullanılan API sürümü, sisteminiz tarafından hangi verilerin depolandığı vb.
- Ekran yayını veya ekran görüntüleri:Bir kayıt veya bir dizi ekran görüntüsü gönderin Bir kullanıcının erişimi reddetmesi veya iD bağlantısını kesmesi durumunda ne olacağı da dahil olmak üzere, entegrasyonunuzun her adımda nasıl çalıştığını açıkça açıklayan ve gösteren açıklamalarla. Kullanılan API sürümü ve verilerin nasıl depolandığı gibi kullanıcı tarafından göremeyeceğimiz herhangi bir şeyi doğrulamak için ek belgeler sağladığınızdan emin olun.
Entegrasyonu
Üye kuruluşlar talebi ORCID Üretim (canlı) sunucusundaki Üye API kimlik bilgilerini tamamlayarak Üretim Üyesi API istemcisi başvuru formu. Listede olmayan bir satıcı sistemi kullanıyorsanız ORCID Sertifikalı Servis Sağlayıcılar, entegrasyonunuzun, aşağıdakilerin sağlanması için bir inceleme sürecinden geçmesi gerekecektir: Entegrasyon ve en iyi uygulamalar için asgari gereksinimler karşılanmaktadır.
Sertifikalı olmayan Hizmet Sağlayıcınızla iletişime geçebilir ve asgari kriterlerin karşılandığına dair doğrudan onlardan kanıt alabilirsiniz. Bu kanıtı şuraya göndermeniz gerekecektir: ORCID Katılım ekibi veya Konsorsiyum Lideriniz.
Bu kanıtı paylaşmanın birkaç yolu vardır:
- Ekran görüntüsü veya ekran görüntüleri: Her adımda entegrasyonunuzun nasıl çalıştığını açıklayan ve gösteren açıklamalarla bir kayıt veya bir dizi ekran görüntüsü gönderin, buna bir kullanıcının erişimi reddetmesi veya kimliğinin bağlantısını kesmesi durumunda ne olacağı da dahildir. Kullanıcı tarafından göremeyeceğimiz herhangi bir şeyi doğrulamak için ek belgeler sağladığınızdan emin olun, örneğin kullanılan API sürümü ve verilerin nasıl depolandığı gibi.
- Kamuya açık entegrasyon dokümantasyonu: Her adımda entegrasyonun nasıl çalıştığına dair net bir açıklama içeren, herkesin erişebileceği ve güncel bir bağlantı gönderin. 1. seçenekte olduğu gibi, kullanılan API sürümü ve verilerin nasıl depolandığı gibi kullanıcı tarafından göremeyeceğimiz herhangi bir şeyi doğrulamak için ek belgeler sağladığınızdan emin olun.
Genel İstemci kimlik bilgileri kuruluşlara değil bireylere verilir. Kimlik bilgileri bir kişiden diğerine aktarılamaz, ancak tüm taraflardan anlaşma alınırsa ve kuruluş aktif bir üyeyse üye API kimlik bilgilerine dönüştürülebilir. ORCID.
İstemci Kimliğini Üye API'sine taşımak İstemci Kimliğini değiştirmez, yalnızca İstemci Gizli Anahtarını değiştirir ve salt okunur izninizle bağlı kimliklerin sayısını korursunuz.
Genel API istemcisini Üye API istemcisine dönüştürürken Genel Müşteri Hizmet Şartları artık geçerli değildir ve Üye Sözleşmesinin hükümleri ile değiştirilirler.
Aktarım için şunlara ihtiyacımız olacak:
- Dönüştürülecek Public API istemci kimliğinin onaylanması.
- Kuruluşun ana irtibat kişisi ve mevcut Public API istemci kimliğinin kayıt sahibinin Hizmet Şartları'ndaki değişikliği kabul etmesi. (Kayıt sahibinin üye kuruluşun bir çalışanı, yüklenicisi veya görevlisi olması gerekir) Her iki tarafın onayının kaydını tutacağız.
- Göçün gerçekleşeceği tarih/saat. Bu göçün bir parçası olarak, istemci kimliğini güncelleyeceğiz ve size şifreli bir e-postada yeni bir istemci sırrı göndereceğiz. İstemciyi güncelledikten sonra, istemci sırrını güncelleyene kadar entegrasyonunuzun çalışmayacağını lütfen unutmayın. Bu nedenle, bunun yapılması için bir tarih ve saat belirlememiz ve kullanıcılar için rahatsızlıkları önlememiz gerekiyor.
Dönüştürmenin tamamlanması için şunları güncellemeniz gerekir:
- Eski müşteri sırrından yeni müşteri sırrına.
- API barındırıcısı pub.orcid.org için api.orcid.org.
Dönüştürülen Üye API'si müşteri kimliğiniz ile, eklemek için kapsamları güncelleyebilirsiniz. üye API kapsamları. Bu, kullanıcıların yetkilendirmesini gerektirecek ve yeni kapsamları/izinleri içerecek şekilde yeni erişim belirteçleri oluşturulacaktır.
Üye API istemcilerinin kimlik bilgilerini Genel API kimlik bilgilerine dönüştüremeyeceğimizi lütfen unutmayın.
Sosyal bileşeni desteklemek için bir araç seti sunuyoruz. Sosyal Yardım Kaynakları entegrasyonunuzu desteklemek için bir kampanya geliştirmenize yardımcı olmak ve araştırmacılarınızla iletişim kurmak için:
- Ne ORCID olduğunu.
- Sisteminizin kimlikleri neden topladığı ve kayıtlarını güncellemek gibi görevleri nasıl gerçekleştireceği.
- Araştırmacılarınız neden bir ORCID iD ve kimliklerini sisteminize bağlama.
- Ne kadar ORCID daha geniş, küresel araştırma topluluğuna fayda sağlar.
Topluluktan gelen geri bildirimlere dayalı olarak bu kaynak "kütüphanesini" sürekli olarak oluşturacağız. Görmek isteyebileceğiniz bir şey için bir fikriniz varsa, lütfen bizimle iletişime geçmekten çekinmeyin.
Yapabilirsin sanal alan Üye API kimlik bilgilerini isteyin Uygulamanızı oluşturmak ve test etmek için. Bu kimlik bilgileri, okuma, yazma ve güncelleme için korumalı alan premium üye API'sine çağrı yapmanıza olanak tanır ORCID kayıtlar. Korumalı alan test ortamına erişim, bir uzman olmasanız bile herkes tarafından ücretsiz olarak kullanılabilir. ORCID üye kuruluş.
not: Eğer kullanıyorsanız ORCID Zaten destekleyen sertifikalı servis sağlayıcı sistemi ORCIDdenemek istemediğiniz sürece korumalı alan API kimlik bilgilerine kaydolmanıza gerek yoktur. ORCID Sandbox ortamında entegrasyon işlevselliği.
Korumalı alan, canlı (üretim) verileri etkileme endişesi duymadan test kullanıcı hesapları oluşturmanıza ve entegrasyonunuzu geliştirmenize olanak tanır. ORCID Kayıt. Korumalı alan, üretimle aynı şekilde davranır ORCID ile kayıt ol birkaç istisna.
test hesabı oluşturma
test etmek için ORCID Okuma ve bir dosyaya bilgi ekleme gibi API ve API çağrıları ORCID kayıt, ayrıca bir test oluşturmanız gerekecek ORCID sandbox'a kaydedin. Bu, üretimde olduğu gibi kullanıcı arabirimi aracılığıyla yapılabilir. ORCID Kayıt. git https://sandbox.orcid.org/register ve bir hesap için kaydolun.
Postacı e-posta adresleri
Korumalı alan sunucusu yalnızca e-postaları gönderir Mailinator (@mailinator.com) e-posta adreslerini istemeden posta sunucularına spam göndermemek için. Bir @mailinator.com adresi kullanmadığınız sürece bir doğrulama e-postası veya parola sıfırlama bildirimi almazsınız ve korumalı alan kayıtlarında herhangi bir manuel düzenleme yapmak için doğrulama gerekir. Ücretsiz genel gelen kutuları hakkında daha fazla bilgi edinin . kullanmak istemiyorsanız Mailinator adresi, ardından lütfen kullanıcı adınızı ve şifrenizi not edin (test sırasında uygulamanıza yetki vermek için bunları kullanacağınız için) ve doğrulama konusunda yardım istemek için bizimle iletişime geçin.
Mailinator halka açık ücretsiz hizmeti ve özel ücretli hizmeti olan bir e-posta hizmetidir. Test için tamamen ücretsiz kamu hizmetini kullanabilirsiniz. Seviyeleri hakkında daha fazla bilgi edinin okuyun.
Mailinator, tarafından yönetilmeyen veya sürdürülmeyen bir üçüncü taraf hizmetidir. ORCID. Bu adresleri kullanmadan önce bu hizmetin nasıl çalıştığını ve sınırlamalarını gözden geçirmenizi öneririz.
Entegrasyonların yalnızca depolamaktan daha fazlasını depolaması gerekir ORCID kayıtlar. Sisteminizin şunları yapabilmesi gerekir:
- Kabul et ve sakla ORCID kimlikler: Sisteminizin aşağıdakileri bilmesi gerekir: iD arasında ORCID görüntülemek için kayıt yapın iD ve doğru şekilde güncellemek için. Bunu, araştırmacının jeton değişimi yanıtında döndürülen bilgileriyle birlikte saklayın. Tavsiyemiz https URI'sinin tamamını saklamanızdır: https://orcid.org/0000-0001-5727-2427.
- Kalıcı olarak kabul et ve sakla erişim belirteçleri ve jetonları yenile: Erişim belirteçleri, kayıtları okumak ve güncellemek ve aynı zamanda iD kimliği doğrulandı. Erişim belirteçleri yaklaşık 20 yıl süreyle veya kullanıcı bunları iptal edene kadar geçerlidir. Ayrıca saklamanızı da öneririz. belirteç kapsamı, belirteç sona erme ve jetonları yenile. Gerektiğinde aynı veya sınırlı kapsamlara sahip yeni erişim belirteçleri oluşturmak için yenileme belirteçleri kullanılabilir. Erişim belirteci belirteci verilerini araştırmacının bilgileriyle birlikte saklayın.
- Kabul et ve sakla kodları koy : Eklediğiniz her öğe ORCID Registry tarafından bir put kodu ile iade edilecektir. ORCID API'dir. Bu 6 haneli koyma kodunu öğenizle birlikte sisteminize kaydedin; böylece hangi öğenin okunması, güncellenmesi veya silinmesi gerektiğini belirleyeceksiniz.
- Bir etkileşim beklendiği gibi gitmediğinde hata mesajları ve bir destek yetkilisi sağlayın.
Geliştiricilerin Genel API'yi şu adreste test etmelerini öneririz: korumalı alan test sunucusu üretim sürümünü kullanmadan önce. Aşağıda, hem Korumalı Alan hem de Üretim ortamlarında genel API kimlik bilgilerine nasıl kaydolacağınıza ilişkin adımlar yer almaktadır.
- oturum senin ORCID kayıt:
Üretim sunucusu: https://orcid.org/signin
Sandbox test sunucusu: https://sandbox.orcid.org/signin - Sağ üst köşedeki adınıza tıklayın
- Tıkla Geliştirici Araçları menü seçeneğinden
Not: Geliştirici Araçları'na erişmek için e-posta adresinizi doğrulamanız gerekir. Henüz e-posta adresinizi doğrulamadıysanız, genel API kimlik bilgilerine kaydolmadan önce yapmanız istenecektir. - Okuyun ve kabul edin'ORCID Genel API'ler Hizmet Şartları
- "Kaydol" düğmesini tıklayın ORCID Genel API Kimlik Bilgileri” düğmesine tıklayın.

Başvuru Detayları Formunun Doldurulması
- Genel API Kimlik Bilgileriniz için kaydolduktan sonra, Geliştirici Araçlarına (https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools).
- Yeni bir başvuru kaydı yapmak için sunulan başvuru ayrıntıları formunu doldurmanız gerekir.
- İsim: Uygulamanızın adı. Bu, uygulamanıza izinlerini alma izni verdiklerinde kullanıcılara gösterilecektir. ORCID iD, ve kendilerinde görüntülenecektir. güvenilir kuruluş listesi. Kuruluşunuzun veya hizmetinizin adını (örneğin bir dergi adı) kullanmanızı öneririz.
- Uygulama URL'si: Kullanıcının uygulamanız hakkında daha fazla bilgi edinmek için ziyaret edebileceği web sitesi. Bu aynı zamanda kendi sayfalarında da görüntülenecektir. güvenilir kuruluş listesi.
- Uygulama Açıklaması: Geliştirmekte olduğunuz uygulama ve kullanıcı bilgilerini nasıl kullanacağınız hakkında bilgiler ORCID İD. Bu, OAuth ekranında kullanıcılara gösterilecektir.

Ekleme Yönlendirme URI'leri
Kullanıcı, uygulamanızı yetkilendirdikten sonra, belirttiğiniz bir URI'ye döndürülür. Bu URI'leri önceden sağlamanız gerekir, aksi takdirde entegrasyon kullanıcılarınız bir hatayla karşılaşır.
- Sağlanan kutuya yönlendirme URI'nizi girin
- 1'den fazla yönlendirme URI'si girmeniz gerekiyorsa, 'Başka bir yönlendirme URI'si ekle'yi tıklayın
Lütfen aklınızda bulundurun:
- Bir tek HTTPS URI'leri üretimde kabul edilir
- Kayıtlı alan adları ZORUNLU alt alanlar da dahil olmak üzere kullanılan alanlarla tam olarak eşleşir
- Mümkün olan yerlerde tüm yönlendirme URI'lerini tam olarak kaydedin. Bu, en güvenli seçenektir ve önerdiğimiz şeydir. Yönlendirme URI'leri hakkında daha fazla bilgi için lütfen şu bölümümüze bakın: yönlendirme URI SSS
Başvurunuz kaydediliyor
Başvuru formunu doldurup yönlendirme URI'lerinizi ekledikten sonra başvurunuzu kaydedebilirsiniz.
- 'Başvurumu kaydet ve istemci kimliğimi ve sırrımı oluştur' seçeneğine tıklayın
Artık Genel API istemcisi kimlik bilgilerinizi içerecek olan geliştirici araçları sayfasına geri yönlendirileceksiniz.

Kimlik bilgilerinizi güncelleme
Başvuru bilgilerinizde değişiklik yapmak çok basit.
- İlgili bilgileri düzenleyin ve ardından 'Uygulamayı kaydet'i tıklayın
Kimlik bilgilerinizi kullanın
Artık kimlik bilgileriniz olduğuna göre, kullanmaya başlamanın zamanı geldi. ORCID Genel API!
Üye olmanız durumunda kimlik bilgilerinizi üye API'sine aktarabileceğimizi lütfen unutmayın. ORCID üye gelecekte.
Tüm üye entegrasyonlarının karşılamasını beklediğimiz bir dizi gereksinim vardır. bu ORCID ekibi, entegrasyon inceleme sürecinin bir parçası olarak bu gereksinimlerin karşılandığından emin olacaktır.
- kullanım OAuth doğrulamak ORCID kimlikler (Kullanıcıların arama yapmasına veya yazmasına izin verme ORCID Kimlikler.)
- OAuth yetkilendirme ekranını bizim tanımlarımıza göre sunun. kuralları yenileyerek
- Ekle ORCID markalı düğme veya bağlantı iD'nin kimlik doğrulamasını başlatmak için sitenizde.
- Sitenizin yönlendirme URI'leri ve üzerinde HTTPS kullanın ORCID API çağrıları
- Belirteç değişiminde döndürülen tüm verileri, kullanıcının verileriyle birlikte sisteminizde kabul edin ve saklayın
- uygun kullanın kapsamları ve istek yöntemleri (örneğin, yeni bilgiler eklemek için POST çağrıları ve mevcut bilgileri güncellemek için PUT çağrıları)
- Kimliği doğrulanmış olanı herkese açık olarak göster ORCID Kimlikler. iD'ler şu şekilde görüntülenmelidir: ticari marka ve iD yönergeleri görüntüleyin.
- Yapma kullanıcılardan, cihazlarındaki öğeler için görünürlük ayarlarını değiştirmelerini isteyin ORCID Entegrasyonunuzu kullanmak için kaydedin.
doldurmanız gerekecek bir müşteri uygulamasını kaydetmek için form. Aşağıda istenen alanlara hızlı bir genel bakış verilmiştir:
Organizasyonun adı: Sizin ORCID üye kuruluş adı
Kimlik bilgileri için birincil iletişim e-posta adresi: Bu e-posta adresini size kimlik bilgilerini şifrelenmiş bir e-postayla göndermek ve entegrasyonunuzla ilgili herhangi bir soru veya hata ortaya çıkarsa sizinle iletişim kurmak için kullanacağız.
Şifre için ikincil e-posta: Şifrelenmiş e-posta şifrenizi gönderebileceğimiz bir e-posta adresi.
Müşterinizin adı: bu senin olacak ORCID üye kuruluşun adı. Eğer 1'den fazla entegrasyonunuz varsa uygulamayı ismin yanına ekleyeceğiz.
Uygulamanızın ana sayfasının URL'si: Kullanıcılar arasında güvenilen kuruluşlar listesinde bir bağlantı olarak görüntülenir ORCID güvenilir taraflar sayfası. Bu, kuruluşunuza veya başvurunuzun ana sayfasına giden bir bağlantı olmalıdır.
İstemci uygulamanızın kısa açıklaması: Bu metin entegrasyon kullanıcılarınıza yetkilendirme ekranında soru işareti simgesiyle birlikte gösterilecektir. Entegrasyonunuzun kısa bir açıklaması gerekli
Yönlendirme URI'leri: Kullanıcı, uygulamanızı yetkilendirdikten sonra, belirttiğiniz bir URI'ye döndürülür. Bu URI'leri önceden sağlamanız gerekir, aksi takdirde entegrasyon kullanıcılarınız bir hatayla karşılaşır.
- Yalnızca HTTPS URI'leri kabul edilir.
- Kaydedilen alan adları, alt alan adları da dahil olmak üzere, kullanılan alan adlarıyla tam olarak eşleşmelidir.
- Mümkün olan yerlerde tüm yönlendirme URI'lerini tam olarak kaydedin.
- 5'ten fazla yönlendirme URI'si gerekli mi? Lütfen bunu Notlarda belirtin ORCID personel.
için notlar ORCID personel: izin vermek için bu alanı kullanın ORCID personel talebiniz veya entegrasyonunuz hakkında ek her şeyi biliyor
Arama ve Bağlantı Sihirbazları öğeleri (çoğunlukla çalışır) içe aktarmak için kullanılabilecek entegrasyonlardır. ORCID Kayıt. Entegratör ve ORCID üretim kayıt ortamına yayınlanmadan önce.
Aşağıdaki sorulara verdiğiniz yanıtlara bağlı olarak, entegrasyonunuz arama ve bağlantı için uygun bir aday olabilir — bir arama ve bağlantı sihirbazı geliştirmeye başlamadan önce bu konuyu daha ayrıntılı görüşmek için lütfen bizimle iletişime geçin:
- Sihirbazın hedef kitlesi nedir? Örneğin, ulusal, disiplin düzeyinde veya küresel düzeyde yazarlar, hakemler veya hibe başvuru sahipleri
- Beklenen kitle kabaca ne kadar büyük?
- Şu anda mevcut sihirbazlar tarafından yetersiz hizmet verilen bir nüfusa hizmet edecek mi? Örneğin, belirli bir dilde veya disiplinde ya da yeni türde olan araştırma katkıları
- Sihirbazın iyi bir kullanıcı deneyimi sunmasını nasıl sağlayacaksınız?
- Hangi kullanıcı desteğini sağlayacaksınız?
- var mı ya da olacak mı? ORCID Sihirbaz için kuruluşunuzdaki ürün yöneticisi gibi bir kişiyi işaret edin?
- bunu nasıl sağlayacaksın ORCID Kimlikler doğrulandı mı?
- Alıp görüntülüyor musunuz - veya alacak mısınız? ORCID Platformunuzdaki kimlikler?
- Platform aramanız iD'ler tarafından etkinleştirildi mi?
Bizim bakın Arama ve Bağlantı İş Akışı daha fazla ayrıntı için.
Üye kuruluşlar talebi ORCID Üretim (canlı) sunucusundaki Üye API kimlik bilgilerini tamamlayarak Üretim Üyesi API istemcisi başvuru formu. Üretim Üyesi API kimlik bilgilerini vermeden önce, ORCID Katılım ekibi/Konsorsiya Lideri entegrasyonunuzun bir demosunu inceleyecektir. ORCID kum havuzu. Bu bize, oluşturduğunuz harika entegrasyonları görme ve iş akışı iyileştirmeleri sunma şansı verir, ayrıca tüm entegrasyonların en iyi uygulamalarımızı ve lansman için minimum gereksinimleri karşılayıp karşılamadığını kontrol etme şansı verir.
Sisteminizin bir demosunu sağlamak için, sistemle çalışan bir entegrasyon kurmanız gerekir. ORCID kum havuzu ORCID ekip önizleme yapabilir. Çalışan sanal alan entegrasyonunuzu paylaşmanın birkaç yolu vardır:
- Önerilen: Canlı demo: Canlı bir gösteri planlamak için bizimle iletişime geçin. Entegrasyonunuzu tanıtmanız için ekranınızı paylaşmanıza olanak tanıyan toplantı yazılımı sağlayacağız.
- Test sitesi: Geliştirme siteniz herkese açıksa, bize URL'yi gönder sisteminize erişmek için test kimlik bilgileri (gerekirse) ve sisteminizin nasıl kullanılacağını açıklayan talimatlar ile birlikte ORCID özellikler. Kullanıcı tarafında göremediğimiz şeyleri doğrulamak için ek belgeler sağlayın, örneğin kullanılan API sürümü, sisteminiz tarafından hangi verilerin depolandığı vb.
- Ekran yayını veya ekran görüntüleri:Bir kayıt veya bir dizi ekran görüntüsü gönderin Bir kullanıcının erişimi reddetmesi veya iD bağlantısını kesmesi durumunda ne olacağı da dahil olmak üzere, entegrasyonunuzun her adımda nasıl çalıştığını açıkça açıklayan ve gösteren açıklamalarla. Kullanılan API sürümü ve verilerin nasıl depolandığı gibi kullanıcı tarafından göremeyeceğimiz herhangi bir şeyi doğrulamak için ek belgeler sağladığınızdan emin olun.
Web kancaları, premium üyelerin 'izlemesine' izin verir ORCID kayıt altına alın ve herhangi bir değişiklikten haberdar olun.
Premium üyeler, API ve premium üye istemci kimlik bilgilerini kullanarak kimliği doğrulanan her biri için bir geri arama URL'si kaydedebilir. ORCID iD izlemek istedikleri. bu ORCID kayıt sahibinin, URL'yi kaydettirmek için kuruluşa özel izin vermesi gerekmez, ancak gerçek veri alışverişi, kayıt sahibi tarafından belirlenen gizlilik seviyelerine dayanır. ORCID iD Kulp.
Bu yerinde ORCID değişiklikler olduğunda bir istek göndererek belirtilen URL'yi bilgilendirecektir. ORCID kayıt.
Metadata
ORCID çeşitli farklı araştırma çıktısı türlerini destekler. Aşağıda şu anda desteklenen çalışma türlerinin bir listesi bulunmaktadır. Mümkün olduğunca COAR (Açık Erişim Depoları Konfederasyonu) Kontrollü kelime dağarcığımız var ve ayrıca API ile hala desteklenen bir dizi eski çalışma türümüz var.
Lütfen bazı çalışma türlerinin yalnızca en son API sürümümüzde desteklendiğini unutmayın.
Akademik Yayınlar
(Kitaplar, dergi makaleleri, konferans çıktıları, ön baskılar ve çalışma kağıtları)
Kullanıcı Arayüzünde ne gösteriyoruz | Entegratörler için API çalışma türü | COAR Kaynak Türü | Açıklama |
Rezervasyon | kitap | kitap | Tek bir ciltte veya belirli sayıda ciltte tamamlanan, seri olmayan yayın. |
Kitap bölümü | kitap bölümü | Bir kitabın genellikle ayrı bir başlığı veya numarası olan tanımlanmış bölümü veya kısmı. | |
Konferans kağıdı | konferans kağıdı | Konferans kağıdı | Bir konferans bildirisi kapsamında yayınlanan, genellikle orijinal araştırma bulgularını bildiren bir araştırma makalesinin gerçekleştirilmesidir. |
Konferans çıktısı | konferans çıktısı | Konferans çıktısı | Diğer daha spesifik çalışma türlerinin kapsamadığı bir konferansa katkıda bulunan her türlü dijital kaynak. Örneğin konferans raporları, konferans dersleri, özetler, gösteriler, atölyeler. Yalnızca API 3.0+ sürümünde mevcuttur |
Konferans sunumu | konferans sunumu | Konferans Sunumu | Bir konferans, sempozyum, seminer, ders, çalıştay veya diğer toplantılarda izleyiciler tarafından izlenmek ve yansıtılmak üzere, fikirleri veya araştırma sonuçlarını iletmek için tasarlanmış, metin, tablo veya şekiller içeren slayt seti. Yalnızca API 3.0+ sürümünde mevcuttur |
Konferans posteri | konferans posteri | Konferans posteri | Genellikle bir konferans bildiri kitabında yayınlanan, açıklayıcı şekiller ve/veya tablolarla birlikte metin içeren, çoğunlukla araştırma sonuçlarını bildiren veya hipotezler öneren, bir konferans, seminer, sempozyum, çalıştay veya benzeri bir etkinliğe kabul için sunulan ve/veya sunulan bir poster. |
Konferans tutanakları | konferans bildirileri | Konferans tutanakları | Konferans tutanakları, bir konferans toplantısının resmi kaydıdır. Konferansta yapılan sunumlara karşılık gelen bir belge koleksiyonudur. Ek içerik içerebilir. Yalnızca API 3.0+ sürümünde mevcuttur |
Dergi makalesi | dergi makalesi | Dergi makalesi | Genellikle orijinal araştırma bulgularını bildiren bir araştırma makalesinin gerçekleştirilmesi olup, bir dergi sayısında yayınlanmış makale. |
Ön baskı | ön baskı | Ön baskı | Ön baskı, hakem değerlendirmesinden geçmemiş ve henüz bir dergi tarafından kabul edilmemiş, genellikle yazar tarafından kamuya açık bir sunucuya/depoya gönderilen bilimsel bir el yazmasıdır. |
Tez veya tez | Bitirme tezi | Tez | Bir öğrencinin yazdığı, yüksek öğrenim kurumunda bir eğitim programını tamamlamak için sınava sunulan araştırma çıktılarının resmi sunumlarını içeren, akademik bir derece için gereklilikleri yerine getiren kitap. Ayrıca tez olarak da bilinir. Yalnızca API 3.0+ sürümünde mevcuttur |
Çalışma kağıdı | çalışma kağıdı | Çalışma kağıdı | Kamuoyuna veya bir grup akran arasında dağıtılan bir çalışma veya tartışma belgesi. Bazı disiplinler, örneğin ekonomi, seri halinde çalışma belgeleri yayınlar. |
Diğer akademik yayınlar | diğer | Yukarıda belirtilenlerin dışında kalan her türlü akademik yayın. |
İnceleme ve düzenleme
(Açıklamalar, transkripsiyonlar, incelemeler ve düzenleme)
Kullanıcı Arayüzünde ne gösteriyoruz | Entegratörler için API çalışma türü | COAR Kaynak Türü | Açıklama |
not | not | Hukuki not anlamındaki açıklama, bir mahkeme veya tahkim kurulu tarafından verilen bir karara ilişkin hukuki olarak açıklayıcı bir yorumdur. Yalnızca API 3.0+ sürümünde mevcuttur | |
Kitap incelemesi | kitap incelemesi | Kitap incelemesi | Bir kitabın veya diğer monografik çalışmanın içeriği, kapsamı ve niteliğinin yazılı incelemesi ve eleştirel analizi. |
Dergi sayısı veya baskısı | dergi sayısı | Dergi | Dergi, belirli bir konu üzerinde yapılan özgün araştırmaları ve güncel gelişmeleri yaymaya adanmış seri yayındır. |
Değerlendirme | yorum | Değerlendirme | Başkalarının yayınlanmış çalışmalarının incelenmesi. Yalnızca API 3.0+ sürümünde mevcuttur |
Transkripsiyon | transkripsiyon | Transkripsiyon | Mahkeme duruşmasında veya bir konuşmada, röportajda, yayında veya ses kaydında söylenen sözlerin yazılı kaydı. Yalnızca API 3.0+ sürümünde mevcuttur |
Çeviri | çeviri | Yeni veya revize edilmiş bir önsöz gibi orijinal baskıdaki değişiklikleri tanımlayan kitap ve makalelerin çevirileri. | |
Diğer inceleme veya düzenleme çıktısı | diğer | Yukarıda belirtilenlerin dışında kalan her türlü inceleme veya düzenleme çıktısı. |
yayma
(Blog yazıları, medya makaleleri, konuşmalar ve podcast'ler)
Kullanıcı Arayüzünde ne gösteriyoruz | Entegratörler için API çalışma türü | COAR Kaynak Türü | Açıklama |
Blog yazısı | Blog yazısı | Blog yazısı | Bir blogda yayınlanan yazı veya diğer içerik. Yalnızca API 3.0+ sürümünde mevcuttur |
Sözlük girişi | sözlük girişi | Yeni kelimelerin girişleri, mevcut kelimelerin yeni anlamları, daha uzun bir süre boyunca yazım ve hecelemedeki değişiklikler ve dilbilgisi değişiklikleri. | |
Ansiklopedi girişi | ansiklopedi girişi | Belirli bir alana veya tüm bilgi dallarına odaklanan bir referans çalışmasında veya bir özette yazılan girdiler. | |
Dergi makalesi | dergi makalesi | Dergi makalesi | Genellikle çeşitli konularda çeşitli yazarlar tarafından yazılmış, akademik olmayan bir üslupla yazılmış makaleler içeren popüler ilgi odaklı süreli yayın veya bir tüketici yayınından farklı olarak, belirli bir alanda veya sektörde çalışan kişilere yönelik belirli bir konuyu ele alan bir ticaret yayınıdır. |
Gazete makalesi | Gazete makalesi | Gazete makalesi | Genel ilgi alanına giren bir gazetede veya diğer genel haber dergilerinde çıkan, belirli bir alandaki güncel ve güncel ilgi çekici bilgileri içeren bir haber öğesinden oluşan çalışma. |
Report | rapor | Report | Rapor, araştırma bulgularının, halen devam eden araştırmaların, politika gelişmelerinin ve olayların veya diğer teknik bulguların ayrı olarak yayınlanmış bir kaydıdır ve genellikle bir rapor numarası ve bazen de fon sağlayan kuruluş tarafından atanan bir hibe numarası taşır. Ayrıca, bir komitenin veya kurumsal varlığın faaliyetlerinin, bir hükümet organının işlemlerinin veya bir kuruluş tarafından yapılan bir soruşturmanın, yayınlanmış veya özel olsun, genellikle gönüllü olarak veya yetki altında daha yüksek bir makama arşivlenen veya sunulan resmi kaydıdır. Daha genel bir anlamda, belirli bir olay veya olguyla ilgili gerçeklerin veya bilgilerin bazen düzenli aralıklarla verilen resmi bir açıklaması. |
Konuşma, röportaj, podcast veya konuşma | kamusal konuşma | Bilginin halka sözlü olarak sunulması. Konuşmalar, röportajlar ve podcast'ler dahil. | |
Web sitesi | Web sitesi | Web sitesi | Ortak bir Tekdüzen Kaynak Bulucu'ya (URL) göre adreslenen metin, resim, video ve/veya diğer dijital varlıkları içeren ilgili web sayfaları koleksiyonu. Bir web sitesi, İnternet veya özel yerel alan ağı gibi bir ağ üzerinden erişilebilen en az bir web sunucusunda barındırılır. |
Diğer yayım çıktıları | diğer | Yukarıda belirtilenlerin dışında kalan her türlü yayım çıktısı. |
Yaratıcı
(Tasarım, görsel, video, müzik, ses ve etkileşimli medya)
Kullanıcı Arayüzünde ne gösteriyoruz | Entegratörler için API çalışma türü | Açıklama | |
Sanatsal çıktı veya performans | sanatsal performans | Bir arada, kişinin araştırma veya bilimsel faaliyetlerinden kaynaklanan veya bunlarla ilgili sanatsal veya performans çıktılarının tam ve güncel geçmişini temsil eden bilgi kayıtlarının toplanması. | |
Tasarım | dizayn | Tasarım | Bir şeyin, örneğin bir binanın, bir ürünün nasıl yapılacağını, nasıl çalışacağını ve görüneceğini gösteren planlar, çizimler veya çizim setleri. Yalnızca API 3.0+ sürümünde mevcuttur |
Resim | görüntü | Resim | Metin dışındaki görsel bir sunum, hareketsiz görüntü.Her türlü hareketli görüntü ve hareketsiz görüntü dahil, metin dışındaki görsel bir sunum. Yalnızca API 3.0+ sürümünde mevcuttur |
Etkileşimli kaynak | çevrimiçi kaynak | Etkileşimli kaynak | Anlaşılması, yürütülmesi veya deneyimlenmesi için kullanıcıdan etkileşim gerektiren bir kaynak. Örnekler arasında Web sayfalarındaki formlar, küçük uygulamalar, multimedya öğrenme nesneleri, sohbet hizmetleri veya sanal gerçeklik ortamları bulunur. |
Hareketli görüntü veya video | hareketli görüntü | Hareketli görüntü | Bilgisayar programı tarafından dinamik olarak oluşturulan veya ardışık olarak gösterildiğinde hareket izlenimi veren bir dizi önceden kaydedilmiş hareketsiz görüntüden oluşan hareketli bir gösterim. Yalnızca API 3.0+ sürümünde mevcuttur |
Müzikal kompozisyon | müzik-kompozisyonu | Müzikal kompozisyon | Müzikal kompozisyon, özgün bir müzik parçası, bir müzik parçasının yapısı veya yeni bir müzik parçası yaratma süreci anlamına gelebilir. Yalnızca API 3.0+ sürümünde mevcuttur |
Ses | ses | Ses | Öncelikle duyulması amaçlanan bir kaynak. Örnekler arasında bir müzik oynatma dosya biçimi, bir ses kompakt diski ve kaydedilmiş konuşma veya sesler bulunur. Yalnızca API 3.0+ sürümünde mevcuttur |
Diğer yaratıcı çıktılar | diğer | Yukarıda belirtilenlerin dışında kalan her türlü yaratıcı çıktı. |
Veri ve süreç
(Veri kümeleri, yazılımlar, planlar ve araştırma araçları)
Kullanıcı Arayüzünde ne gösteriyoruz | Entegratörler için API çalışma türü | COAR Kaynak Türü | Açıklama |
Kartografik materyal | kartografik-malzeme | Kartografik materyal | Dünyanın veya herhangi bir gök cisminin tamamını veya bir kısmını herhangi bir ölçekte temsil eden herhangi bir malzeme. Kartografik malzemeler arasında iki ve üç boyutlu haritalar ve planlar (hayali yerlerin haritaları dahil); havacılık, seyir ve gök haritaları; atlaslar; küreler; blok diyagramlar; kesitler; kartografik amaçlı hava fotoğrafları; kuşbakışı görünümler (harita görünümleri) vb. yer alır. Yalnızca API 3.0+ sürümünde mevcuttur |
Klinik çalışma | klinik çalışma | Klinik çalışma | Biyomedikal veya sağlıkla ilgili sonuçlarda müdahaleleri veya maruziyetleri değerlendirmek için bir araştırma çalışmasının sonuçlarını raporlayan bir çalışma. İki ana klinik çalışma türü müdahaleli çalışmalar (klinik denemeler) ve gözlemsel çalışmalardır. Çoğu klinik çalışma insanları ilgilendirse de, bu yayın türü insanlar için gereklilikleri karşılayan klinik veterinerlik makaleleri için kullanılabilir. Yalnızca API 3.0+ sürümünde mevcuttur |
Veri kümesi | veri seti | Veri kümesi | Tanımlı bir yapı içerisinde kodlanmış, birbiriyle ilişkili olgu ve verilerin koleksiyonu. |
Veri yönetimi planı | veri yönetimi planı | Veri yönetimi planı | Bir araştırma projesi boyunca araştırma verilerinin nasıl yönetileceği ve belgeleneceğini ve verilerin uzun vadeli yönetim ve saklama amacıyla bir veri deposuna daha sonra nasıl depolanacağına ilişkin şartları açıklayan resmi bir açıklama. Yalnızca API 3.0+ sürümünde mevcuttur |
Fiziksel nesne | fiziksel nesne | Fiziksel örnek | Fiziksel örnekler arasında biyolojik örnekler, kaya veya mineral örnekleri, toprak veya tortu çekirdekleri, bitkiler ve tohumlar, su kalitesi örnekleri, arkeolojik eserler veya DNA ve insan doku örnekleri bulunur. Örnekler analizlerde kullanılabilir ve bu süreçte imha edilebilirken, örnekler sürekli olarak incelenebilen korunan küratörlü nesnelerdir. Yalnızca API 3.0+ sürümünde mevcuttur |
Araştırma protokolü veya tekniği | araştırma tekniği | araştırma protokolü | Araştırmanın bir parçası olarak belirlenen belirli görevlere uygulanan pratik yöntemler veya beceriler. |
Araştırma aracı | Araştırma aleti | Araştırmadan belirlenen gözlemler, ölçümler veya gerçekler dizisi. | |
Yazılım | yazılım | Yazılım | Kaynak kodu (metin) veya derlenmiş formdaki bir bilgisayar programı. |
Diğer veri veya işlem çıktısı | diğer | Yukarıda belirtilenlerin dışında kalan her türlü veri veya işlem. |
Hukuk ve Fikri Mülkiyet
(Patentler, ticari markalar, telif hakları ve diğer yasal konular)
UI Etiketi | Entegratörler için API çalışma türü | COAR Kaynak Türü | Açıklama |
İcat | buluş | Araştırmadan doğan pratik ve özgün çıktılar. | |
Lisans | lisans | Bir süreç, ürün, veri veya yazılım gibi bir IP parçasından yararlanmak için imzalanan anlaşmalar. | |
Patent | patent | Patent | Patent veya patent başvurusu. |
Tescilli telif hakkı | tescilli telif hakkı | Sanatsal, edebi, müzikal, dramatik ve diğer yaratıcı eserlerin hem yaratılmasını hem de bunlara erişimi teşvik etmek için bir yasalar sistemi kapsamında hakların tescilli mülkiyeti. | |
Standartlar veya politika | standartlar ve politika | Yargı için bir temel olarak kullanılan bir kural veya ilkenin geliştirilmesi. | |
marka | marka | marka | Bir teşebbüsün mallarını veya hizmetlerini diğerlerinden ayırt etmek için kullanılan bir işaret. Bir ticari marka, kelimelerden ve kelime kombinasyonlarından (örneğin, isimler veya sloganlar), logolardan, şekillerden ve resimlerden, harflerden, sayılardan, seslerden veya nadir durumlarda kokulardan veya hareketli resimlerden veya bunların bir kombinasyonundan oluşabilir. |
Diğer yasal veya IP çıktısı | diğer | Yukarıda belirtilenlerin dışında kalan her türlü hukuki veya fikri mülkiyet çıktısı. |
Öğretim ve Denetim
(Öğrencilerle çalışma)
Kullanıcı Arayüzünde ne gösteriyoruz | Entegratörler için API çalışma türü | COAR Kaynak Türü | Açıklama |
okuma | ders-konuşma | okuma | Örneğin bir üniversite veya kolej öğretmeni tarafından belirli bir konu hakkında bilgi sunmak veya insanlara bir şeyler öğretmek amacıyla yapılan sözlü sunum/konuşmanın yazıya dökülmesi. |
Öğretim materyali | öğrenme nesnesi | Öğrenme nesnesi | Öğretim ve öğrenmeyi geliştirmek için yeniden kullanılabilen dijital bir kaynak. Yalnızca API 3.0+ sürümünde mevcuttur |
Denetlenen öğrenci yayını | gözetimli-öğrenci-yayın | Tez danışmanı ile birlikte veya danışmanlığında yayınlanan araştırma bulgularına ilişkin makaleler. | |
Diğer öğretim veya denetim çıktıları | diğer | Yukarıda belirtilenlerin dışında kalan her türlü öğretim ve denetim çıktısı. |
Eski İş Türleri
Aşağıda API'lerimizle hala desteklenen ancak kullanıcıların işleri manuel olarak eklerken artık seçemediği iş türlerinin bir listesi bulunmaktadır. Mümkün olduğunda, bunun yerine kullanılması önerilen iş türlerini listeledik.
Çalışma tipi | Uygulanabilirse önerilen çalışma türü | |
konferans özeti | konferans çıktısı | |
ifşa | ||
düzenlenmiş Kitap | kitap | |
Manuel | öğrenme nesnesi | |
haber bülteni makalesi | dergi makalesi veya gazete makalesi | |
yan şirket | ||
teknik standartlar | rapor | |
test | öğrenme nesnesi |
Tüm bağlantı bölümleri, API'de aynı meta veri kümesini kullanır:
- Kuruluş Adı:* En üst düzeyde kuruluşun adı (örn. "Boston University School of Medicine" yerine "Boston University").
- Organizasyon şehri:* Kuruluşun bulunduğu şehir.
- Kuruluş bölgesi: Kuruluşun bulunduğu bölge.
- Organizasyon ülkesi* kuruluşun ülkesi. Bu ile doldurulmalıdır iki harfli ISO 3166 Alpha-2 ülke kodu.
- Kuruluş Kimliği (ROR, GRID, Ringgold** veya LEI):* Kuruluş ve kaynağı için benzersiz bir tanımlayıcı. Bağlılık içinde ana kuruluş kimliğinin kullanılmasını ve bölüm veya departmanda kullanılmamasını öneririz.
- Rol ünvanı: Tutulan pozisyon veya verilen veya verilecek derece.
- Bölümü: Üst kuruluşun herhangi bir alt bölümü.
- URL: Bağlantıyla ilgili bir kaynağın URL'si
- Başlangıç tarihi: Araştırmacı ile kurum arasındaki ilişkinin başladığı tarih (yıl, ay ve gün olarak belirtilebilir).
- Bitiş tarihi: Araştırmacı kurum ilişkisinin sona erdiği tarih (yıl, ay, gün olarak belirtilebilir)
- Bağlantıyı açıklayan harici bir kalıcı tanımlayıcı: Gerçek üyelik iddiası için benzersiz bir tanımlayıcı
*Bir alanın zorunlu olduğunu gösterir.
**Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS Daha fazla bilgi için.
Bir biyografi bölümünün altında birkaç bölüm vardır. ORCID kayıt:
Ayrıca şöyle bilinir: Bu, kısaltılmış bir ilk adı, bir veya daha fazla adın baş harflerini içeren varyantları, ikinci adı/adları, eski veya alternatif adları veya farklı bir karakter kümesindeki adları içerebilir. Her isim tek bir öğe olarak eklenmelidir. Bu, 255 karaktere kadar ücretsiz bir metin alanıdır.
web siteleri: Bu bölüm bir açıklama (isteğe bağlı) ve bir web sitesi URL'si (gerekli) içerir.
Ülke: Ülke bölümü ORCID record, araştırmacıların ve üye kuruluşların araştırma yaptıkları veya araştırmalarının konusu olan bir veya daha fazla ülkeyi eklemelerine olanak tanır. Ülke listesindeki öğeler, ülke ve bölge kodları için uluslararası standart olan ISO 3166'dan alınmıştır.
Harici tanımlayıcılar (Diğer Kimlikler): Bu bölüm sadece üye kuruluşlar tarafından eklenebilir. Pek çok kuruluş, araştırmacıları için Scopus Yazar Kimlikleri gibi başka harici tanımlayıcılar toplasa da, yalnızca bu tanımlayıcıları veren kuruluşun bunları yetkili olarak ileri sürebileceğini lütfen unutmayın. Bu nedenle, kuruluşunuzun yalnızca sisteminizin/sistemlerinizin oluşturduğu ve araştırmacıları tanımlamak için kullandığı tanımlayıcıları eklemesini önemle tavsiye ederiz. Bu bölüm dört bileşen içerir (* zorunlu alanı gösterir):
- Kimlik türü*
- kimlik değeri*
- kimlik ilişkisi*
- Kimlik URL'si
- Başlık:* Çalışmanın adı
- Alt yazı: Çalışmaya bir alt başlık
- Çevrilmiş başlık: Eserin başka bir dilde yer aldığı başlık, çevrilen başlığın dili öznitelik olarak kaydedilir.
- Gazete başlığı: Dergi makaleleri için bir dergi veya kitap bölümleri için bir kitap gibi, çalışmanın ait olduğu daha büyük bir koleksiyonun adı. Bu, dergi başlığı olarak etiketlenmiş olsa da, diğer çalışmalar için kullanılabilir.
- Kısa Açıklama: Çalışmanın kısa bir açıklaması veya özeti
- Alıntı türü: Alıntının sağlandığı format. Bu alan, aşağıdaki değerleri içeren bir listeden seçilir: APA, BIBTEX, CHICAGO, HARVARD, IEEE, MLA, RIS, UNSPECIFIED, VANCOUVER
- Atıf değeri: Alıntı içeriği
- Çalışma tipi: Çalışmanın nesne türü. Bu alan şu seçeneklerden seçilmelidir: desteklenen iş türleri
- Yayın Tarihi: Çalışmanın yayınlandığı tarih. En erken yayın tarihinin kullanılmasını öneririz
- Harici kimlik türü:* tanımlayıcı türü. Bu alan şu seçeneklerden seçilmelidir: desteklenen iş tanımlayıcıları
- Harici kimlik değeri:* tanımlayıcının kendisi
- Harici kimlik URL'si: Tanımlayıcının çözdüğü bir url
- Harici kimlik ilişkisi:* Yalnızca eklenen iş için geçerli olan tanımlayıcılar, Öz olarak işaretlenir. Bu çalışmanın ait olduğu daha büyük bir koleksiyon için geçerli olan tanımlayıcılar, Part-of olarak ayarlanır. Çalışmanın alternatif sürümleri için geçerli olan tanımlayıcılar, version-of olarak ayarlanır. İş için finansman için geçerli olan tanımlayıcılar, tarafından finanse edilecek şekilde ayarlanacaktır.
- Çalışma url'si: Çalışmaya bağlanan bir url
- İşe katkıda bulunanlar: Eseri oluşturan kişiler hakkında bilgi
- Dil kodu: Önceki alanlarda yapılan işi anlatmak için kullanılan dil
- Ülke: Çalışmanın yayınlandığı veya başka bir şekilde ilişkilendirildiği bir ülke
* Gerekli alanı gösterir
Tek kullanımlık reaktiflerden özel tesislere sahip uluslararası işbirlikçilerine kadar pek çok araştırma kaynağı vardır. ORCID etki alanına özgü ayrıntılar için başka yerlere bağlanabilen üst düzey bir modeli destekler.
Dört üst düzey kaynak türü vardır:
Kaynak tipi | Tanım | Örnekler |
Altyapı | Araştırma yapmak için kullanılan bir tesis, bina veya başka bir fiziksel alan | Nötron parçalanma kaynağı, hayvan tesisi, veri bölgesi, arkeolojik alan, teleskop dizisi. gemiler, uçaklar, çiftlikler, laboratuvarlar |
Koleksiyon | Araştırma amacıyla kullanılan bir nesne veya nesne grubu; somut veya dijital olabilir | Okyanus misyonu, saha kampanyası, işbirlikçi veri kümeleri veya kaynakları, nadir bulunan kitap koleksiyonu; müze koleksiyonu, biyolojik numune koleksiyonu |
Ekipman | Araştırma amaçlı kullanılan donanımlar | Mikroskop, bilgisayarlar, züccaciye, numuneler, malzemeler |
Hizmet | Araştırma amaçlı kullanılan hizmetler | Proteomik analiz, bilgi işlem hizmetleri, veri analizi, lojistik destek, yasal hizmetler, kopya düzenleme, uzman veya personel danışmanlığı |
Kaynak türüne ek olarak, bir araştırma kaynağı öğesi ORCID kayıt aşağıdaki bilgileri içerir. * gerekli öğeleri gösterir
- Teklif/Kayıt Başlığı:* Bu, "Nötron Işın Ödülü" veya "Işın süresi ve bilgi işlem kaynakları" gibi araştırma kaynakları için ana görüntüleme alanıdır.
- Teklif/Kayıt Kimliği:* Bu, kaynağı kullanma teklifi veya talebi için genel tanımlayıcıdır (DOI, PURL, vb.). İdeal olarak, bu tanımlayıcı kalıcı olmalı ve ödül veri tabanı veya kaynak kullanıcı günlüğü gibi teklif veya talep hakkında bilgi içeren genel bir açılış sayfasına çözümlenmelidir.
- Teklif Sahibi(leri):* Bu, kaynak tekliflerini veya isteklerini alan ve işleyen kuruluştur. Teklif Ana Bilgisayarı, Kaynak Ana Bilgisayar ile aynı olabilir
- Teklif Ev Sahibi Kuruluş Kimliği* Bu, teklif veya talep sürecini yöneten kuruluşun genel tanımlayıcısıdır (ROR, GRID, Open Funder ID, LEI'den biri).
- Kaynaklar):* (100'e kadar)
- Kaynak Adı:* – örneğin, “Nötron Spallasyon Kaynağı”
- Kaynak kimlik(ler):* – genişletilebilir bir kabul edilebilir PID türleri listesinden (örn. RRID, DOI, URI)
- Kaynak tipi:* – 'Altyapılar', 'Koleksiyonlar', 'Ekipman' veya 'Hizmetler'den biri
- Kaynak Sunucu(lar):* Bu, ulusal bir laboratuvar, devlet kurumu veya araştırma üniversitesi gibi Kaynağı yöneten veya işleten kuruluştur.
- Kaynak Ana Bilgisayar Kuruluş Kimliği:* Bu, kaynağı barındıran kuruluşun genel tanımlayıcısıdır (ROR, GRID, Ringgold**, Open Funder ID, LEI'den biri)
- Teklif URL'si: Teklife bir bağlantı
- Teklif Başlangıç Tarihi: Erişimin başladığı tarih
- Teklif Bitiş Tarihi: Erişimin sona erdiği veya sona ereceği tarih
* Gerekli alanı gösterir
**Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS Daha fazla bilgi için.
- Rol:* Kişinin değerlendirme sürecindeki rolü: başkan, editör, üye, düzenleyici, gözden geçiren arasından seçilebilir.
- Grup tanımlayıcısı:* Toplama amaçları için kullanılan grup kimliği — dergi makaleleri için varsayılan tanımlayıcı, ISSN veritabanıyla bir entegrasyon yoluyla otomatik olarak doldurulan eISSN'dir. Lütfen, ISSN dışında bir tanımlayıcı atamanız gerekirse, önce oluşturun.
- Toplantı organizasyonu*: İncelemeyi düzenleyen kuruluş – bir dergi yayıncısı, konferans organizatörü, fon sağlayan kuruluş, fakülte vb.
- Kuruluş tanımlayıcısı: Toplantıyı yapan kuruluşun kalıcı tanımlayıcısı. Şu anda ROR, Ringgold**, GRID, LEI veya Crossref Funder Registry tanımlayıcısını destekliyoruz. Lütfen unutmayın: Bu zorunlu bir alan değildir ancak elinizde varsa bu verileri göndermenizi öneririz.
- Verileri inceleyin:* Bu veriler, incelenenleri değil, inceleme faaliyetini ifade eder
- Tip: Gözden geçirme faaliyetinin türü: gözden geçirme veya değerlendirme
- Tarih: İncelemenin tamamlandığı tarih. Bu geniş (2008) veya spesifik (2010-12-10) olabilir.
- İnceleme tanımlayıcısı: Eşsiz, tercihen çözülebilir tanımlayıcı incelemenin kaynağı tarafından sağlanır. İnceleme açıkça mevcut olmadığı sürece, bunun incelemenin konusuna kadar izlenebilecek tanımlanabilir veriler içermemesini öneririz.
- İnceleme URL'si: İncelemenin veya inceleme kaydının çevrimiçi temsiline bir bağlantı
- İnceleme konusu hakkında bilgi: İnceleyen ne olursa olsun inceledi
- Konu türü: İncelenen öğenin türü, örneğin dergi makalesi, konferans bildirisi
- Buna aşağıdakiler dahildir: iş türleri listesi VE hibe türleri listesi (“hibe”, “sözleşme”,”ödül”,”maaş-ödül”) VE araştırma-“kaynak-teklifi” VE “tanımsız”
- Özne ismi: İncelenen öğenin adı
- Konu dış tanımlayıcısı: İnceleme konusunun benzersiz tanımlayıcısı, örneğin bir makalenin DOI'si
- Konu kapsayıcı adı: İnceleme konusunun parçası olduğu nesnenin adı, örneğin makalenin gözden geçirildiği konferans
- Konu URL'si: İncelenen konunun URL'si
- Konu türü: İncelenen öğenin türü, örneğin dergi makalesi, konferans bildirisi
* Gerekli alanı gösterir
**Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS Daha fazla bilgi için.
- Finansman türü:* Verilen fon türü, Bu alan aşağıdaki değerleri içeren bir listeden seçilir: Ödül, Sözleşme, Hibe, Maaş-ödül
- Finansman başlığı:* Finansman kaleminin başlığı
- Alt yazı: Finansman kaleminin alt başlığı
- Çevrilmiş başlık: Finansmanın başka bir dilde altında göründüğü başlık, çevrilen başlığın dili bir özellik olarak kaydedilir.
- Açıklama: Finanse edilen projenin açıklaması veya kısa özeti.
- tutar: ödülün değeri
- Benzersiz finansman tanımlayıcısı: * Sisteminizin farkında olduğu kadar çok sayıda bu tür öğeyi ekleyin, bu, gruplandırmaya yardımcı olur. ORCID Kayıtlar.
- Finansman tanımlayıcı türü: Hibe numarası, DOI, URI veya teklif kimliği kullanın
- tanımlayıcının değeri
- Tanımlayıcı URL (isteğe bağlı)
- İlişki: öz/parçası
Bu, finansman kaleminin tanımlayıcıyla ilişkisini belirtmek içindir. Örneğin, finansman kalemi çok parçalı bir hibenin bir aşaması içinse ve tanımlayıcı çok parçalı hibe içinse, ilişki "parçası" olacaktır; tanımlayıcı bireysel aşama için ise, o zaman ilişki "kendi" olacaktır.
- Finans kuruluşu (kuruluş):* Finansmanı sağlayan kuruluş hakkında bilgi
- ajansın adı
- Adres (şehir ve ülke)
- Kuruluş tanımlayıcısı: Desteklenen tanımlayıcılar ROR, Fundref ve Ringgold** tanımlayıcılarıdır.
- Başlangıç tarihi: Finansmanın başladığı tarih
- Bitiş tarihi: Finansmanın sona erdiği tarih
- Katkıda bulunanların bilgileri: Fonu alan kişiler hakkında bilgi
- ORCID İD: The ORCID iD Finansman projesine her bir ortak çalışanın; bu yalnızca kimliği doğrulanmış bilgileri içermelidir ORCID kimlikler
- Rol: Araştırmacının katkısının niteliği
* Gerekli alanı gösterir
**Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS Daha fazla bilgi için.
Tüm bağlantı bölümleri, API'de aynı meta veri kümesini kullanır:
- Kuruluş Adı:* En üst düzeyde kuruluşun adı (örn. "Boston University School of Medicine" yerine "Boston University").
- Organizasyon şehri:* Kuruluşun bulunduğu şehir.
- Kuruluş bölgesi: Kuruluşun bulunduğu bölge.
- Organizasyon ülkesi* kuruluşun ülkesi. Bu ile doldurulmalıdır iki harfli ISO 3166 Alpha-2 ülke kodu.
- Kuruluş Kimliği (ROR, GRID, Ringgold** veya LEI):* Kuruluş ve kaynağı için benzersiz bir tanımlayıcı. Bağlılık içinde ana kuruluş kimliğinin kullanılmasını ve bölüm veya departmanda kullanılmamasını öneririz.
- Rol ünvanı: Tutulan pozisyon veya verilen veya verilecek derece.
- Bölümü: Üst kuruluşun herhangi bir alt bölümü.
- URL: Bağlantıyla ilgili bir kaynağın URL'si
- Başlangıç tarihi: Araştırmacı ile kurum arasındaki ilişkinin başladığı tarih (yıl, ay ve gün olarak belirtilebilir).
- Bitiş tarihi: Araştırmacı kurum ilişkisinin sona erdiği tarih (yıl, ay, gün olarak belirtilebilir)
- Bağlantıyı açıklayan harici bir kalıcı tanımlayıcı: Gerçek üyelik iddiası için benzersiz bir tanımlayıcı
*Bir alanın zorunlu olduğunu gösterir.
**Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS Daha fazla bilgi için.
Tüm bağlantı bölümleri, API'de aynı meta veri kümesini kullanır:
- Kuruluş Adı:* En üst düzeyde kuruluşun adı (örn. "Boston University School of Medicine" yerine "Boston University").
- Organizasyon şehri:* Kuruluşun bulunduğu şehir.
- Kuruluş bölgesi: Kuruluşun bulunduğu bölge.
- Organizasyon ülkesi* kuruluşun ülkesi. Bu ile doldurulmalıdır iki harfli ISO 3166 Alpha-2 ülke kodu.
- Kuruluş Kimliği (ROR, GRID, RInggold** veya LEI):* Kuruluş ve kaynağı için benzersiz bir tanımlayıcı. Bağlılık içinde ana kuruluş kimliğinin kullanılmasını ve bölüm veya departmanda kullanılmamasını öneririz.
- Rol ünvanı: Tutulan pozisyon veya verilen veya verilecek derece.
- Bölümü: Üst kuruluşun herhangi bir alt bölümü.
- URL: Bağlantıyla ilgili bir kaynağın URL'si
- Başlangıç tarihi: Araştırmacı ile kurum arasındaki ilişkinin başladığı tarih (yıl, ay ve gün olarak belirtilebilir).
- Bitiş tarihi: Araştırmacı kurum ilişkisinin sona erdiği tarih (yıl, ay, gün olarak belirtilebilir)
- Bağlantıyı açıklayan harici bir kalıcı tanımlayıcı: Gerçek üyelik iddiası için benzersiz bir tanımlayıcı
*Bir alanın zorunlu olduğunu gösterir.
**Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS Daha fazla bilgi için.
Tüm bağlantı bölümleri, API'de aynı meta veri kümesini kullanır:
- Kuruluş Adı:* En üst düzeyde kuruluşun adı (örn. "Boston University School of Medicine" yerine "Boston University").
- Organizasyon şehri:* Kuruluşun bulunduğu şehir.
- Kuruluş bölgesi: Kuruluşun bulunduğu bölge.
- Organizasyon ülkesi* kuruluşun ülkesi. Bu ile doldurulmalıdır iki harfli ISO 3166 Alpha-2 ülke kodu.
- Kuruluş Kimliği (ROR, Ringgold**, GRID veya LEI):* Kuruluş ve kaynağı için benzersiz bir tanımlayıcı. Bağlılık içinde ana kuruluş kimliğinin kullanılmasını ve bölüm veya departmanda kullanılmamasını öneririz.
- Rol ünvanı: Tutulan pozisyon veya verilen veya verilecek derece.
- Bölümü: Üst kuruluşun herhangi bir alt bölümü.
- URL: Bağlantıyla ilgili bir kaynağın URL'si
- Başlangıç tarihi: Araştırmacı ile kurum arasındaki ilişkinin başladığı tarih (yıl, ay ve gün olarak belirtilebilir).
- Bitiş tarihi: Araştırmacı kurum ilişkisinin sona erdiği tarih (yıl, ay, gün olarak belirtilebilir)
- Bağlantıyı açıklayan harici bir kalıcı tanımlayıcı: Gerçek üyelik iddiası için benzersiz bir tanımlayıcı
*Bir alanın zorunlu olduğunu gösterir.
**Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS Daha fazla bilgi için.
An ORCID kayıt, bir araştırmacının çalışması, bağlantıları, finansmanı, akran değerlendirmesi ve daha fazlası hakkında bilgi içerebilir.
üzerindeki öğeler ORCID kayıtlar bölünebilir iddialar bağlayan ORCID Bir aktiviteye veya bağlantıya sahip kimlik sahibi. Bu iddialar bir eklenebilir ORCID Kaydın sahibi olan araştırmacı tarafından veya araştırmacının izin verdiği sistemler tarafından kayıt altına alınır. Bir iddiaya bir iddia ekleyen varlığı çağırıyoruz. ORCID kaydet kaynak.
Örnekler


Şeffaflık ve açıklık ilkelerimize uygun olarak, iddianın kaynağını, yani bu bilgiyi kayda kimlerin eklediğini görebilmenin önemli olduğuna inanıyoruz. Bunu şu şekilde yapıyoruz:
- Bir araştırmacı (veya vekilleri) güvenilir kişi) kayıtlarına bir iddia ekler, ORCID o kişiyi otomatik olarak kaynak olarak kaydeder
- Araştırmacı tarafından onaylanan bir sistem bir kayda iddia eklediğinde, ORCID sistem sahibini otomatik olarak kaydeder (bir ORCID üye) kaynak olarak.
Kaynak adını kullanıcı arayüzünde görüntüler ve API'de (benzersiz tanımlayıcısıyla) kullanılabilir hale getiririz:
Bununla birlikte, araştırma bilgisi iş akışları bundan daha karmaşık olabilir ve bir iddianın gerçek kaynağı, bir kişi veya başka bir sistem adına bir öğe ekleyen bir sistem tarafından istemeden gizlenebilir. Şeffaflığı sağlamak için, kişi ile öğe arasındaki bağlantıyı kimin kurduğunu ve öğeyi kayda kimlerin eklediğini ayırt etmemiz gerekir. Yukarıdaki gibi, öğeyi kim eklerse ORCID kayıt kaynak; arasındaki bağlantıyı kim kurarsa, ORCID iD ve öğe iddia kökeni.
Örneğin:
- Bir araştırmacı, verileri bilgisayarına aktarır. ORCID Arama ve Bağlantı Sihirbazı gibi bir sistemden kayıt. Araştırmacı, onları birbirine bağlayan bir iddiada bulunuyor. iD öğe ile, yani onlar iddia kaynağı; sistem ise iddiayı ekleyen varlıktır. ORCID kayıt - kaynak
- Bir araştırmacı Sistem A ile etkileşime girer ( iddia kaynağı), güncellemek için Sistem B tarafından sağlanan hizmetleri kullanan ORCID kayıtlar, Sistem B'yi kaynak

Topluluğumuzu, herkesin kaynağı görmekten yararlanabilmesi için iddia kaynağı hakkındaki bilgileri korumak ve paylaşmak için adımlar atmaya teşvik ediyoruz.
Daha fazla bilgi için, bakın:
Çalıştığı yer ORCID hem tanımlayıcılarına hem de bu tanımlayıcıların eserle olan ilişkisine göre birlikte gruplandırılır. Dört tür ilişki vardır:
- öz: tanımlayıcı yalnızca o esere atıfta bulunur ve aynı tanımlayıcıya sahip diğer eserlerle gruplandırılabilir
- Bir parçası: çalışma, bu tanımlayıcının bir parçasıdır ve diğer çalışmalarla gruplandırılamaz
- Sürüm: bu tanımlayıcılar, çalışmanın alternatif sürümleri için geçerlidir ve self ve tanımlayıcıların sürümü ile gruplandırılabilir
- Tarafından finanse edildi: bu tanımlayıcılar, işin finansmanı için geçerlidir. Bu tanımlayıcılar, gruplandırma çalışmaları için kullanılmaz.
API'miz XSD'de bunun için destek sağlar. Her öğenin, kendi grubu içindeki sıralamasını gösteren bir görüntüleme indeksi özelliği vardır. En yüksek görüntüleme indeksi araştırmacı tarafından seçilen tercih edilen öğedir. API aracılığıyla eklenen ve araştırmacı tarafından derecelendirilmeyen öğelerin görüntüleme indeksi 1'dir ve araştırmacı tarafından değiştirilene kadar grup içinde varsayılan tercih edilen kaynak olarak kullanılır. Ekran endeksi aynı zamanda okuma sırasında iş sırasını da belirler. ORCID API ile kaydedin.
gruplandırma hakkında daha fazla bilgi için ORCID kayıtlar, lütfen bizim destek makalesi.
Bizim bakın desteklenen tanımlayıcıların listesi V3.0 API için. Talep üzerine ara sıra yeni tipler ekliyoruz. ORCID Kayıt defterine öğe eklerken bunları kullanmak isteyen üyeler.
ORCID kullanımını destekler ROR tanımlayıcıları, GRID tanımlayıcıları ve Crossref Fon Sağlayıcı Kaydı kuruluşlardaki belirsizliği gidermek için tanımlayıcılar ORCID Kayıtlar.
Daha fazla bilgi için bkz: Kuruluş Tanımlayıcılarıyla Çalışma
Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS daha fazla bilgi için
Eşleştirme ve gruplandırma amacıyla harici tanımlayıcıları (DOI'ler, PMCID, PMID, ArXiv, Bibcode, ISSN'ler ve ISBN'ler) normalleştirilmiş bir biçimde ifade eden, sistem tarafından oluşturulmuş yeni bir alanı kullanıma sunduk. Normalleştirme, tanımlayıcı türünün kurallarına göre yapılır ve tüm alfa karakterlerini küçük harfe ayarlamayı veya boşlukları, tireleri, noktaları ve eşdeğer olarak değerlendirilebilecek diğer karakterleri dönüştürmeyi içerebilir. Ayrıca uygun şekilde standart önekler ve sonekler ekler. Örneğin, https://doi.org/10.1/123, 10.1/123, ve https://dx.doi.org/10.1/123 hepsi bu alanda şu şekilde görünecek: https://doi.org/10.1/123. Mevcut tanımlayıcı değeri değiştirilmemiştir.
Çalışmalar ve fonlama bölümündeki katkıda bulunan alanı, üye entegrasyonlarının bir çalışmada işbirliği yapmış veya fonlanan bir projede taraf olan araştırmacıları listelemesine olanak tanır.
Hem fonlama hem de çalışmalar için, katkıda bulunanın ORCID iD rolün yanında. Katkıda bulunanları eklemenizi öneririz ORCID yalnızca kimlik doğrulaması yaptıysanız kimlikler ORCID kimliği veya ORCID iD doğrulayan bir kaynaktan. Birden fazla rol eklenebilir.
Katkıda bulunan dizisi, işbirlikçinin veya diğer katkıda bulunanın adlarının katkıda bulunan listesinde nerede görünmesi gerektiğini belirtmek için kullanılır. Desteklediğimiz 2 seçenek şunlardır:
- Ad
- Ek
API 2.0 işler için roller
API 2.0 kullanılarak desteklenen katılımcı rollerinin listesi aşağıdadır.
- yazar
- vekil
- editör
- başkan veya tercüman
- yardımcı araştırmacı
- ortak mucit
- Mezun öğrenci
- diğer mucit
- Baş araştırmacı
- doktora sonrası araştırmacı
- destek personeli
API 3.0 işler için roller
API 3.0 ile yukarıdaki rollere ek CRedIT rolleri ekleyebilirsiniz. CRediT taksonomisi şunlardan oluşur: Bilimsel çalışmalara 14 katkı türü, bu rollerin nasıl atanabileceğine ilişkin yönergelerle birlikte.
Aşağıda UI değeri, rol açıklaması ve meta veri değeriyle birlikte tam liste bulunmaktadır. Meta veri değeri, NISO uygulama önerilerine göre URL'dir.CRediT, bu bağlantı aracılığıyla açıklanan JATS xml v1.2'de kodlanmalıdır: https://jats4r.org/credit-taxonomy. '
API aracılığıyla roller eklenirken yalnızca URL kabul edilecektir.
TERM (UI Değeri) | AÇIKLAMA | URL (API Değeri) |
kavramsallaştırma | Fikirler; kapsamlı araştırma hedef ve amaçlarının formülasyonu veya evrimi. | https://credit.niso.org/contributor-roles/conceptualization/ |
Veri iyileştirme | Açıklama ekleme (meta veri üretme), veri temizleme ve bakım yapma yönetim faaliyetleri (Verilerin yorumlanması için gerekli olduğu durumlarda yazılım kodu dahil) ilk kullanım için araştırma verileri ve daha sonra tekrar kullanılabilir. | https://credit.niso.org/contributor-roles/data-curation/ |
Biçimsel analiz | İstatistiksel, matematiksel, hesaplamalı veya diğer resmi tekniklerin uygulanması çalışma verilerini analiz etmek veya sentezlemek. | https://credit.niso.org/contributor-roles/formal-analysis/ |
Finansman edinimi | Bu yayının ortaya çıkmasına yol açan projeye maddi destek sağlanması. | https://credit.niso.org/contributor-roles/funding-acquisition/ |
soruşturma | Bir araştırma ve soruşturma sürecini yürütmek, özellikle aşağıdakileri gerçekleştirmek: deneyler veya veri/kanıt toplama. | https://credit.niso.org/contributor-roles/investigation/ |
metodoloji | Metodolojinin geliştirilmesi veya tasarlanması; modellerin oluşturulması. | https://credit.niso.org/contributor-roles/methodology/ |
Proje Yönetimi | Araştırma faaliyeti planlamasının yönetim ve koordinasyon sorumluluğu ve yürütme. | https://credit.niso.org/contributor-roles/project-administration/ |
Kaynaklar | Çalışma materyalleri, reaktifler, malzemeler, hastalar, laboratuvar örnekleri, hayvanların sağlanması, enstrümantasyon, hesaplama kaynakları veya diğer analiz araçları. | https://credit.niso.org/contributor-roles/resources/ |
Yazılım | Programlama, yazılım geliştirme; bilgisayar programları tasarlama; bilgisayar kodu ve destekleyici algoritmalar; mevcut kod bileşenlerinin test edilmesi. | https://credit.niso.org/contributor-roles/software/ |
Gözetim | Araştırma faaliyetinin planlanması ve yürütülmesine ilişkin gözetim ve liderlik sorumluluğu, çekirdek ekibin dışındaki mentorluk da dahil. | https://credit.niso.org/contributor-roles/supervision/ |
Onaylama | Faaliyetin bir parçası olarak veya ayrı olarak, genel olarak doğrulanması Sonuçların/deneylerin ve diğer araştırma çıktılarının tekrarlanabilirliği/yeniden üretilebilirliği. | https://credit.niso.org/contributor-roles/validation/ |
Görüntüleme | Yayımlanmış eserin hazırlanması, yaratılması ve/veya sunulması, özellikle görselleştirme/veri sunumu. | https://credit.niso.org/contributor-roles/visualization/ |
Yazma - orijinal taslak | Yayımlanmış eserin hazırlanması, yaratılması ve/veya sunulması, özellikle İlk taslağın yazılması (özlü çeviri dahil). | https://credit.niso.org/contributor-roles/writing-original-draft/ |
Yazma-inceleme ve düzenleme | Yayımlanmış eserin hazırlanması, yaratılması ve/veya sunulması, orijinal araştırma grubundan, özellikle eleştirel inceleme, yorum veya revizyon - ön veya yayın sonrası aşamalar. | https://credit.niso.org/contributor-roles/writing-review-editing/ |
Örnek çalışmaya katkıda bulunan meta verileri:
https://orcid.org/0000-0001-5109-3700 0000-0001-5109-3700 orcid.org Laure L. Haak first author
Finansman için roller
- öncülük etmek
- yardımcı başrol
- Tarafından desteklenen
- diğer katkı
ORCID bilgilerin araştırmacılar tarafından kolayca metin biçiminde girilebilmesi için ücretsiz bir metin alıntı alanı sağlar. Ancak, tüm API kullanıcılarının, makine tarafından okunabilen BibTeX'te alıntılar eklemelerini önemle tavsiye ederiz. Saygıdeğer format, internetin eski tarihlendirmesine rağmen, entegrasyonlar ve yazarlar tarafından istenen formata dönüştürülebilir. Çoğu referans yöneticisi ve yayın platformu tarafından desteklenir.
BibTeX hakkında daha fazla bilgi için bkz. https://www.bibtex.org.
Yayıncılarının DOI kaydı için Crossref kullandığı tüm yazarlar, Crossref otomatik güncelleme entegrasyonundan yararlanabilir.
Yayıncıların kimliği doğrulanmış bilgileri eklemesi gerekir ORCID DOI kaydında Crossref'e gönderilen meta veriler içindeki yazarlarının kimlikleri.
Crossref daha sonra bir bildirim yoluyla yazardan izin isteyecektir. ORCID güncellemek için gelen kutusu ORCID bu yayınla ve herhangi bir yayıncının yeni yayınlarıyla kaydedin.
Daha fazla bilgi için lütfen bakınız: https://www.crossref.org/community/orcid/
İçindeki her öğe ORCID iD benzersiz bir şekilde tanımlayan bir koyma kodu atanır. Bir kaydın veya bölümün tamamını okurken, koyma kodu, öğenin bir özelliği olarak bulunabilir. Ne zaman bir kayıttaki belirli bir öğeyi çağırmak, put kodu öğeyi tanımlamak için kullanılır. Koyma kodları, başvurdukları öğe türü içinde benzersizdir. Bu örneği kullanarak, yalnızca bir çalışma ORCID Sicil, 733535 put koduna sahip olacaktır, ancak 733535, bir finansman kalemi veya bir anahtar kelime için bir put kodu olarak da kullanılabilir.
bir yararı olarak ORCID üyelik, kuruluşlar sorabilir ORCID ek PID türlerini desteklemek için ORCID Kayıt. Örneğin, bir üye, jeoloji veri tabanlarında numuneleri veya veri kümelerini tanımlamak için kullandıkları PID'ler için destek eklememizi talep edebilir. Bu, numuneler ve onları toplayan kişiler arasında bağlantılar sağlar. Ve eklediğimiz tüm yeni PID türlerinin en azından çözülebilir ve tercihen ADALET olması gerektiğinden, bu bağlantılar açık, zaman içinde kalıcı ve eyleme geçirilebilir - araştırmacıya, üye kuruluşa ve daha geniş topluluğa fayda sağlar.
PID'nizi Eklemek!
Bir toplum kuruluşu olarak, bunu sağlamak istiyoruz. ORCID üyelerimiz tarafından kullanılan PID'leri destekler. Tam bir bakım yapıyoruz Kayıt Defterinde desteklenen mevcut tanımlayıcıların listesi ve davet et ORCID kullanılacak üyeler Airdrop Form ek PID'ler istemek için. Talebinize en kısa sürede cevap vermeyi hedefliyoruz.
ORCID içinde ayrı bir bölüm var ORCID nitelikler, akreditasyon, sertifikalar ve rozetler hakkında bilgileri kaydetmek için kayıt.
Her yeterlilik öğesi her zaman şunları içerecektir:
- Yeterlilik başlığı
- Sağlayıcının Kuruluş Kimliği (örneğin ROR Kimliği)
- Eklendiği tarih ORCID kayıt
- Kalifikasyonu kim ekledi (kaynak)
Şunları içerebilirler:
- Yeterliliğin sona ermesi durumunda bitiş tarihi dahil olmak üzere geçerlilik tarihi
- Kazanılan kalifikasyon türünü tanımlayan kalifikasyon kalıcı kimliği.
- Kazanılan kalifikasyon türünün insanlar tarafından okunabilir açıklamasını içeren kalifikasyon URL'si.
- Nitelik kalıcı kimliği. Bu, nitelik sertifikasının çevrimiçi bir sürümüne bağlanmalıdır. Bu, mevcut benzersiz bir kimlik veya basitçe bir URI olabilir.
Kimlik doğrulama ve OAuth
Genel veya üye API kimlik bilgilerine sahip olan herkes, /okuma-genel erişim belirteci. Bir belirteç almak için, ORCID API belirteci bitiş noktası.
Bu işleme genellikle istemci kimlik bilgileri OAuth akışı veya 2 adımlı OAuth denir.
Korumalı alandaki genel verileri okumak üzere bir erişim belirteci almak için örnek bir çağrı — yer tutucuları kimlik bilgilerinizle değiştirin (köşeli ayraçları çıkardığınızdan emin olun.
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
Daha sonra size aşağıdakine benzer bir erişim belirteci iade edilecektir. Döndürülen belirteç uzun ömürlüdür (yaklaşık 20 yıl boyunca sona ermez) ve genel verileri almak için birden çok kez kullanılabilir. ORCID Kayıtlar.
{"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}
Not: /authenticate kapsamına sahip tüm belirteçler artık /read-public kapsamına da sahip. Yalnızca /authenticate kapsamını kullanırsanız, yeniden bir erişim belirteci almanıza gerek kalmadan genel verileri okumak için saklanan erişim belirteçlerini kullanabilirsiniz.
Üye API'sini kullanan entegratörler şunları kullanabilir: /okuma-genel okuma kapsamı ORCID özetleri kaydedin.
/read-limited erişimi elde etmek için araştırmacıdan izin istemeniz gerekir. Bunu OAuth kullanarak yaparsınız. özellikle, “3 aşamalı OAuth".
Daha fazla bilgi için lütfen bizim API Öğreticisi: Bir bilgisayardaki verileri okuyun ORCID kayıt
ORCID entegrasyonlar, kullanıcıların kimliğini doğrulamak ve kayıtlarıyla etkileşim izni istemek için "3 aşamalı OAuth" kullanır. Herhangi bir entegrasyon, Genel API'yi kullanarak okuma izinleri isteyebilir. ORCID üyeler, güncelleme izinlerini istemek için Üye API'sini kullanabilir. Şu şekilde çalışır:
- Özel bir bağlantı oluşturursunuz
- Tıklandığında, kullanıcı şu adrese gönderilir: ORCID
- ORCID kullanıcıdan oturum açmasını ister
- ORCID kullanıcıdan uygulamanıza izin vermesini ister
- ORCID kullanıcıyı bir yetkilendirme kodu ile sisteminize geri gönderir
- Sisteminiz bu kodu bir erişim belirteci ile değiştirir
Özelleştirilmiş yetkilendirme URL'si, müşteri bilgilerinizin yanı sıra kayıtlarının erişmek istediğiniz belirli alanlarını belirten 'kapsamları' içerir. Oturum açtıktan sonra, kullanıcı sisteminizle bağlantı yetkisi verir ve bir yetkilendirme koduyla birlikte açılış sayfanıza geri döner. Bu kod daha sonra onların almak için kullanılır ORCID iD istenen kapsamlar için geçerli bir erişim belirteci ile birlikte.
API kimlik bilgilerinizin istemci kimliğini ve ilişkili açılış sayfasını (yönlendirme URI'si) belirterek yetkilendirme bağlantınızı oluşturursunuz. Hangi izinlerin isteneceğini ayarlayarak seçersiniz kapsam parametresi.
Aşağıdaki örnek, bilgisayardaki sınırlı erişim verilerini okumak için izin istemektedir. ORCID sanal alan test sunucusu. Gerçek dünyada, bu bağlantıyı web sitenizde görüntülersiniz veya kullanıcıdan kimlik doğrulaması ve yetkilendirme yapmasını isterken bir e-postaya eklersiniz. Ancak, test amacıyla web tarayıcınıza yapıştırmanız yeterlidir. Parantez içindeki verileri müşteri bilgilerinizle değiştirin ve köşeli parantezleri çıkardığınızdan emin olun!
https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]
Bir kullanıcı bağlantıya tıkladı, şu adreste oturum açtı: ORCID ve verilen izinler sitenize geri yönlendirilir, bunun gibi:
https://[Your landing page]?code=Q70Y3A
için yetkilendirme kodunu hemen değiştirmelisiniz. ORCID iD ve erişim belirteci. Yetkilendirme kodunun kullanım süresi sona erer. İstek şuna benziyor ve bir web tarayıcısında yapılamaz, sunucunuz tarafından yapılmalıdır.
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 daha sonra araştırmacının kimliği doğrulanmış ORCID iD ve JSON biçiminde bir erişim belirteci:
{"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"}
Erişim belirteçleri varsayılan olarak uzun ömürlüdür ve verildikten 20 yıl sonra sona erer. Belirteç, süresi dolmadan önce birden çok kez kullanılabilir.
Erişim belirtecini kullan
3 aşamalı erişim belirteçleri, belirli ORCID kayıt. Bunları kullanmak için, bu kaydı okumak veya güncellemek için yaptığınız API isteklerine dahil edersiniz.
Biriyle etkileşim kurmak için izin isterken ORCID kullanıcının kaydı, bir veya daha fazla 'kapsam' belirtirsiniz. Her kapsam, kaydı okumak veya belirli bir bölümü güncellemek gibi belirli şeyler yapmanıza izin verir.
3 bacaklı bir kullanıcıdan izin alma sürecinde yer alan üç aktörü ifade eder; ORCID, sisteminiz ve kullanıcının kendisi.
/doğrula 
Bu kapsam, ORCID iD ve yalnızca kayıttaki genel bilgileri okuyun. Diğer tüm 3 aşamalı kapsamlar, kimlik doğrulama iznini içerir, bu nedenle başka bir erişim istenirse bu kapsam atlanabilir. Bu kapsam, Üye veya Genel API'de mevcuttur.
/read-limited (yalnızca üye API'si) 
Bu kapsam, genel ve sınırlı görünürlük öğelerinin okunmasına erişim elde etmek için kullanılır. ORCID kayıt. Bu kapsam yalnızca Üye API'sinde mevcuttur.
/aktiviteler/güncelleme (yalnızca Üye API'sı) 
Bu kapsam, bir derginin üyelik, finansman, çalışmalar, mesleki faaliyetler, araştırma kaynakları ve hakem incelemesi bölümlerindeki öğelerin yazılması, güncellenmesi ve silinmesi için kullanılır. ORCID kayıt. Bu kapsam yalnızca Üye API'sinde mevcuttur.
/person/update (yalnızca üye API'si) 
Bu kapsam, kaydın diğer adlar, anahtar sözcükler, ülkeler, araştırmacı URL'leri, web siteleri ve kişisel dış tanımlayıcılar bölümlerindeki öğeleri yazmak, güncellemek ve silmek için kullanılır. Bu kapsam yalnızca Üye API'sinde mevcuttur.
açık kimlik
Bu kapsam, bir id_token gerektiğinde OpenID entegratörleri tarafından kullanılır. Openid kapsamı dahil edildiğinde, Kayıt Defteri belirteç yanıtı içinde bir id_token döndürür ve istemciye o kullanıcı için kullanıcı bilgisi uç noktasına erişme izni verir. Bu kapsam, genel ve üye API'sinde mevcuttur.
Lütfen 'openid' kapsamının diğerleri gibi bir '/' ile başlamadığını unutmayın. ORCID API kapsamları. Bunun nedeni, 'openid' kapsamının şu şekilde tanımlanmamasıdır: ORCID, ancak bunun yerine OpenID Connect belirtimi tarafından tanımlanır. lütfen bizimkine bakın OpenID belgeleri daha fazla bilgi için.
Birden çok kapsam
Kapsam=/read-limited%20/activities/update%20/person/update gibi, kimlik doğrulama URL'sindeki kapsamları aralarında kodlanmış bir boşlukla listeleyerek tek bir etkileşimde birden çok kapsam talep edilebilir
Tam erişim
Bir kaydı okumak ve düzenlemek için tam erişim istiyorsanız, kimlik doğrulama URL'nize üç kapsam ekleyin: /read-limited, /activities/update ve /person/update. URL'de kapsam=/read-limited%20/activities/update%20/person/update olarak görünürler.
2 aşamalı (müşteri kimlik bilgisi) kapsamları
Bazı aktiviteler için kullanıcıdan izin almanıza gerek yoktur. İki aşamalı OAuth kapsamları doğrudan ORCID API ve araştırmacının izin vermesini gerektirmez. Bu kapsamlara sahip jetonlar 20 yıl geçerlidir ve yeniden kullanılabilir.
/okuma-genel
Bu kapsam, genel bilgileri tek bir cihazda okumak için kullanılır. ORCID kimlik, ara ORCID kayıtları veya özet bilgileri okumak için (yalnızca üye API'si). Bu kapsam Üye veya Genel API'de mevcuttur.
/web kancası
Bu kapsam, bir istemci uygulamasının bir web kancasını bir ORCID Bir kayıt güncellendiğinde bildirim almak için kayıt. Bu kapsam premium olarak kullanılabilir ORCID sadece üyeler.
Birden fazla kullanıcının aynı makinede olması ve oturumlar arasında çıkış yapmaması ile ilgileniyorsanız, OAuth işlemi sırasında onları yeniden kimlik doğrulaması yapmaya zorlayabilirsiniz. Basitçe ekleyin prompt=login
OAuth isteğinde. Ayrıca, oturumları belirli bir sürenin üzerindeyse kullanıcıları yeniden kimlik doğrulaması yapmaya zorlamak için saniye cinsinden bir max_age ayarlayabilirsiniz. bizim görmek OpenID Bağlantı belgeleri daha fazla ayrıntı için.
Kullanıcılar ekran dillerini herhangi bir noktada kendi başlarına değiştirebilir. Aşağıdaki dil ayarları mevcuttur:
Dil | Kod |
عربى (Arapça) | ar |
čeština (Çek) | cs |
İngilizce | en |
Español (Spanish) | es |
Français (Fransızca) | fr |
Deutsch (Almanca) | de |
İtalyanca (İtalyanca) | it |
日本語 (Japonca) | ja |
한국어 (Korece) | ko |
Polski (Lehçe) | pl |
Portekizce (Portekizce) | pt |
Русский (Rusça) | ru |
Türkçe (Türkçe) | tr |
简体中文 (basitleştirilmiş Çince) | zh_CN |
繁體中文 (geleneksel Çince) | zh_TW |
Parametrelerden herhangi biri veya tümü kullanılabilir:
Parametre | Alan | notlar |
Lakaplar | İsim | The isim alan doldurulacaktır kayıt formu belirtilen bir e-posta adresi veya ORCID iD bir aktifinkiyle eşleşmiyor ORCID kayıt. |
aile isimleri | Soyadı | The soyadı alan doldurulacaktır kayıt formu belirtilen e-posta adresi veya ORCID iD bir aktifinkiyle eşleşmiyor ORCID kayıt. |
E-posta | E-posta | The e-posta /ORCID iD alan doldurulacaktır giriş formu belirtilen e-posta adresi sistemimizde bulunuyorsa ve geçerli değilse ORCID iD belirtilir. E-posta alan doldurulacaktır kayıt formu belirtilen e-posta adresi sistemimizde bulunuyorsa ve geçerli değilse ORCID iD belirtildi.E-posta adresi şu olmalıdır: URL kodlanmış, “@” öğesinin “%40” olarak değiştirilmesi dahil. Kullanıcının kim olduğunu biliyorsanız ORCID iD ve e-posta adresini öneriyoruz bir tek sağlamak ORCID iD orcid parametresinde. |
orcid | ORCID iD | The e-posta /ORCID iD alan doldurulacaktır giriş formu belirtilen ise ORCID iD sistemimizde bulunur. kayıt formu Aksi takdirde, aksi belirtilmedikçe görüntülenecektir. ORCID iD sistemimizde bulunmamaktadır. ORCID iD içinde olmalı 16 haneli format iD URI. |
Bu parametrelere sahip örnek bir URL:
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

OAuth yetkilendirme URL'nizin talep ettiği kapsamlarla aynı etkin erişim belirteci zaten varsa ve kullanıcı kendi hesabında oturum açmışsa ORCID kayıt, tekrar yetki vermeleri istenmeyecektir. Bunun yerine doğrudan yönlendirme URI'sine götürülecekler. Bir kullanıcının her bağlandıklarında yetki vermesini zorunlu kılmak istiyorsanız, zorla oturum kapatma yöntemi
Örtülü OAuth, sunucu tarafı bileşenleri olmayan veya kullanmak istemeyen sistemler tarafından kullanılmak üzere tasarlanmış daha hafif bir OAuth sürümüdür. Örtük OAuth, yalnızca javascript kullanılarak tamamen tarayıcıda uygulanabilir. Üyeler ve üye olmayanlar tarafından kullanılabilir ve şu şekilde çalışır:
- Özel bir bağlantı oluşturursunuz
- Tıklandığında, kullanıcı şu adrese gönderilir: ORCID
- ORCID kullanıcıdan i imzalamasını ister
- ORCID kullanıcıdan uygulamanıza izin vermesini ister
- ORCID ile kullanıcıyı sisteminize geri gönderir. ORCID iD, bir erişim belirteci ve bir kimlik belirteci.
- Sisteminiz, kimliği doğrulanmış verileri ayıklar ve depolar ORCID iD yanıttan.
Güvenlik nedenleriyle örtük OAuth kullanılırken, ORCID güncelleme izinlerine sahip erişim belirteçlerini döndürmez.
örtük akış
Örtülü akış, istemcilerin başlatmak için gizli anahtarlarını kullanmalarına gerek kalmayacak şekilde tasarlanmıştır. ORCID oturum açın. Güvenlik, istemcileri kayıtlı yönlendirme_url'leriyle sınırlayarak sağlanır. Bu daha düşük güvenlik seviyesi şu anlama gelir: ORCID örtülü akış kullanılırken yalnızca /authenticate ve openid kapsamlarını destekler. Jetonlar da kısa ömürlüdür ve 10 dakikalık bir ömre sahiptir. Bu akış, örneğin telefon uygulamaları veya tek sayfa javascript web uygulamaları gibi bir arka uç sunucuya erişimi olmayan istemci tarafı uygulamaları için önerilir.
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
Our bakın teknik döküman daha fazla bilgi için.
Yönlendirme URI'leri nedir ve nasıl kullanılır?
Yönlendirme URI'leri, OAuth kimlik doğrulama hizmetimiz tarafından bir güvenlik önlemi olarak kullanılır. ORCID yalnızca kimlik doğrulaması yapan kullanıcıları, kimlik doğrulama talep eden istemci tarafından kaydedilen URI'lere gönderir. Bu, hizmetlerin birbirinin kimliğine bürünmesini engeller.
Unutmayın ki yalnızca HTTPS URI'leri üretimde kabul edilir. HTTP URI'lerini kullanarak test edebilirsiniz ancak kayıt olmanız gerekir HTTPS URI'leri üretim üyesi API kimlik bilgileri için başvurduğunuzda.
Yönlendirme URI'lerini nasıl eşleştiririz?
- Alt alan adlarını ayrı URI'ler olarak kaydetmeniz GEREKİR. https://anythingelse. Thirdparty.com çalışmayacaktır.
- Yol da dahil olmak üzere tüm yönlendirme URI'lerinin tam olarak kaydedilmesi önerilir, çoğu üçüncü tarafın yaptığı şeydir ve en güvenli seçenektir.
- İstemci uygulaması, yalnızca ana bilgisayar adı olan bir yönlendirme uri'si ile kayıtlıysa, o ana bilgisayardaki herhangi bir yönlendirme uri'si kullanılabilir. Örneğin, aşağıdaki yönlendirme uri'si kayıtlıysa: https://thirdparty.com o zaman aşağıdaki tüm yönlendirme_uris çalışacaktır:
- https://thirdparty.com/oauth/callback1
- https://thirdparty.com/callback2
- https://thirdparty.com/anything-else-as-long-as-the-host-is-the-same
Ancak, https://anythingelse. Thirdparty.com çalışmayacak. Sen ZORUNLU alt etki alanlarını ayrı URI'ler olarak kaydedin.
Yönlendirme URI'm yanlışsa ne olur?
Kimlik doğrulaması için gönderilen kullanıcılar ORCID yanlış yönlendirme URI'leri ile şuna benzer bir hata mesajı görürsünüz:
Üyeler için yönlendirme URI'lerini yönetme
Üye API'sini kullanıyorsanız ve yönlendirme URI'lerinizde herhangi bir değişiklik yapmanız gerekiyorsa, lütfen Etkileşim Ekibimizle iletişime geçin.
Genel istemciler için yönlendirme URI'lerini yönetme
Herkese açık API'yi kullanıyorsanız, sizinle ilişkili yönlendirme URI'leri listenizi güncellemek için aşağıdaki adımları izlemeniz gerekir. ORCID genel API istemci kimliği. Aşağıdaki adımları izleyerek bunu yapabilirsiniz:
- Giriş yapın ORCID kayıt
- Sağ köşedeki adınıza tıklayın
- Geliştirici araçlarını seçin
- Müşteri adının yanındaki düzenle kalemini tıklayın
- Mevcut bir yönlendirme URI'sini düzenleyin veya "Başka bir yönlendirme URI'si ekle"yi tıklayın, mevcut bir yönlendirme URI'sini düzenleyin
- Değişikliklerinizi yaptıktan sonra kaydet simgesine tıklamanız gerekir.
Yalnızca HTTPS URI'leri üretimde kabul edilir. http URI'lerini kullanarak test edebilirsiniz ancak üretim üyesi API kimlik bilgileri için başvurduğunuzda HTTPS URI'lerini kaydetmeniz gerekecektir.
OpenID Connect 1.0, OAuth 2.0 protokolünün üzerinde basit bir kimlik katmanıdır. Mevcut OAuth kimlik doğrulama akışlarını tamamlar ve kullanıcılar hakkında istemcilere iyi tanımlanmış bir şekilde bilgi sağlar.
OpenID connect, OAuth'u uygulamanın ve kimliği doğrulanmış kullanıcılar hakkında bilgi paylaşmanın standartlaştırılmış bir yoludur. Kullanılacak hizmetleri yapılandırmak artık mümkün olacak ORCID "Kutudan çıktığı gibi" diğer standartlara uygun OpenID bağlantı sağlayıcılarının yanında. OpenID bağlantısı ayrıca, bir kullanıcının kimlik doğrulaması yaptığını kanıtlayabilen imzalanmış nesneler olan paylaşılabilir kimlik belirteçleri de sağlar ORCID belirli bir zamanda Bu belirteçler, kullanıcı oturumlarını sürdürmek için kullanıcı arabirimi öğeleri tarafından kullanılabilir.
ORCID OAuth yetkilendirme kodu akışının bir uzantısı olan Temel OpenID Sağlayıcı uyumluluk profilini destekler. ORCID ayrıca "/authenticate" ve "openid" kapsamları için örtük belirteç akışını da destekler.
Bu demektir ki, ORCID:
- 'openid' kapsamıyla oluşturulan yetkilendirme kodları için belirteç yanıtlarına imzalı kimlik belirteçlerini yerleştirir
- "Token" veya "token id_token" yanıt_tipleri ve "openid" kapsamı kullanılırken örtük akışı destekler.
- "openid" kapsamını içeren yetkilendirme istekleri için "prompt", "nonce" ve "max_age" parametrelerini destekler.
- Openid Connect keşfini ve userinfo uç noktalarını destekler
- 'openid' kapsamını içeren yetkilendirme istekleri için üye API'sini kullanan entegratörler için 'amr' alanını destekler. Bu, bir kullanıcının iki faktörlü kimlik doğrulama kullanarak kimliğini doğrulayıp doğrulamadığını keşfetmek için kullanılabilir.
Bir OpenID Connect kimlik doğrulaması başlatmak, normal bir OAuth kimlik doğrulamasıyla aynı şekilde çalışır. Gereken tek şey, istemcinin 'openid' kapsamını istemesidir. /authenticate kapsamını kullanıyorsanız, bunu openid ile değiştirin, çünkü kimlik doğrulama ve openid aynı yetkiye sahiptir, yalnızca biri veya diğeri kullanılmalıdır. Başka kapsamlar kullanıyorsanız, talep edilen kapsamlar listesine openid'i ekleyin. Openid kapsamı dahil edildiğinde, Kayıt Defteri belirteç yanıtı içinde bir id_token döndürür ve istemciye o kullanıcı için kullanıcı bilgisi uç noktasına erişme izni verir.
'openid' kapsamının diğerleri gibi bir '/' ile başlamadığını unutmayın. ORCID API kapsamları. Bunun nedeni, 'openid' kapsamının şu şekilde tanımlanmamasıdır: ORCID, ancak bunun yerine OpenID Connect belirtimi tarafından tanımlanır.
Our bakın teknik döküman daha fazla bilgi için.
ORCID kullanıcıların etkinleştirmesine izin verir İki faktörlü kimlik doğrulama (2FA) üzerinde ORCID hesap. 2FA, oturum açma işlemi sırasında yapılan ikincil bir güvenlik kontrolüdür. Kullanıcının gerçekten bir oturum açan kişi olduğuna dair ek onay sağlar. ORCID hesap. Bunun kullanıcılar için nasıl yapılandırılabileceği ile ilgili daha fazla bilgi için lütfen şu bölümümüze bakın: KB makalesi.
Açık Kimlik üye API'sini kullanan bağlantı entegratörleri, kullanıcının oturum açıp açmadığını kontrol edebilir. ORCID OAuth işleminin bir parçası olarak 2FA'nın etkinleştirildiği hesap. Bu, üye entegratörlerin araştırmacılarına daha yüksek güvenlik sistemlerine erişim izni vermesine izin verebilir.
Ile tutarak onların araştırmacı kontrolüne olan bağlılığımız ORCID kayıt, kayıt sahibi, herhangi bir erişim belirtecini, herhangi bir zamanda, izinlerden silerek iptal etmeyi seçebilir. Güvenilir Kuruluşn Güvenilir taraflar sayfasının altındaki liste.
2018 itibariyle, araştırmacılar, kullanıcı izni iptal etmedikçe yalnızca 20 yıl süren uzun ömürlü erişim belirteçleri verebilir.
ORCID basit sağlar Java Komut Dosyası widget'ı kimlik doğrulaması elde etmek için kullanılabilecek ORCID OpenID Connect ile OAuth kullanan kimlikler.
Widget'ın örtük OAuth kullandığını ve dolayısıyla herhangi bir yazma izni toplamadığını lütfen unutmayın. Bu, kayıtları güncellemek isteyen üye entegrasyonları için uygun olmadığı anlamına gelir. Lütfen eğitimimize bakın Veri ekleme ve güncelleme ORCID Kayıtlar.
ORCID API
Genel İstemci kimlik bilgileri kuruluşlara değil bireylere verilir. Kimlik bilgileri bir kişiden diğerine aktarılamaz, ancak tüm taraflardan anlaşma alınırsa ve kuruluş aktif bir üyeyse üye API kimlik bilgilerine dönüştürülebilir. ORCID.
İstemci Kimliğini Üye API'sine taşımak İstemci Kimliğini değiştirmez, yalnızca İstemci Gizli Anahtarını değiştirir ve salt okunur izninizle bağlı kimliklerin sayısını korursunuz.
Genel API istemcisini Üye API istemcisine dönüştürürken Genel Müşteri Hizmet Şartları artık geçerli değildir ve Üye Sözleşmesinin hükümleri ile değiştirilirler.
Aktarım için şunlara ihtiyacımız olacak:
- Dönüştürülecek Public API istemci kimliğinin onaylanması.
- Kuruluşun ana irtibat kişisi ve mevcut Public API istemci kimliğinin kayıt sahibinin Hizmet Şartları'ndaki değişikliği kabul etmesi. (Kayıt sahibinin üye kuruluşun bir çalışanı, yüklenicisi veya görevlisi olması gerekir) Her iki tarafın onayının kaydını tutacağız.
- Göçün gerçekleşeceği tarih/saat. Bu göçün bir parçası olarak, istemci kimliğini güncelleyeceğiz ve size şifreli bir e-postada yeni bir istemci sırrı göndereceğiz. İstemciyi güncelledikten sonra, istemci sırrını güncelleyene kadar entegrasyonunuzun çalışmayacağını lütfen unutmayın. Bu nedenle, bunun yapılması için bir tarih ve saat belirlememiz ve kullanıcılar için rahatsızlıkları önlememiz gerekiyor.
Dönüştürmenin tamamlanması için şunları güncellemeniz gerekir:
- Eski müşteri sırrından yeni müşteri sırrına.
- API barındırıcısı pub.orcid.org için api.orcid.org.
Dönüştürülen Üye API'si müşteri kimliğiniz ile, eklemek için kapsamları güncelleyebilirsiniz. üye API kapsamları. Bu, kullanıcıların yetkilendirmesini gerektirecek ve yeni kapsamları/izinleri içerecek şekilde yeni erişim belirteçleri oluşturulacaktır.
Üye API istemcilerinin kimlik bilgilerini Genel API kimlik bilgilerine dönüştüremeyeceğimizi lütfen unutmayın.
Bu örnek arama, tam bir özetini alır ORCID sanal alan sunucusundaki üye API'sini kullanarak XML biçiminde kaydedin. Genel veya Üye API'ye API istekleri yapmak için bir erişim belirtecine ihtiyacınız var.
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
API, isteğin başarıyla alındığını ve tam özetini belirten bir 200 OK mesajı döndürür. ORCID münferit öğelerin özetleri dahil olmak üzere kayıt
<?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>
Her öğenin (iş, finansman, istihdam vb.) kod koymak. Bu, gerekirse öğenin tüm ayrıntılarını elde etmek için kullanılabilir.
The ORCID kayıt, kaydı daha hızlı ve daha tutarlı bir şekilde okumak için ayrı bölümlere ayrılmıştır. Önce özetini almak için bir bölümü arayabilir ve ardından o öğe hakkında sağlam bilgi almak için tek bir öğenin yerleştirme kodunu kullanarak arayabilirsiniz.
API'yi okumak için kullanabileceğiniz özet bölümlerin bir tablosu aşağıda verilmiştir.
Son nokta | Açıklama |
/ kayıt | Tamamının özet görünümü ORCID kayıt |
/kişi | Biyografik bölüm ORCID aşağıdaki /araştırmacı-url'leri dahil olmak üzere kayıt |
/Özet | Doğrulanmış ve kendi kendine onaylanan öğelerin özet görünümü ORCID kayıt (yalnızca üye API'sinde kullanılabilir) |
/adres | Araştırmacının ülkeleri veya bölgeleri |
/e-posta | Kayıtla ilişkili e-posta adres(ler)i |
/harici tanımlayıcılar | Diğer sistemlerdeki bağlantılı harici tanımlayıcılar |
/anahtar kelimeler | Araştırmacı ve çalışmaları ile ilgili anahtar kelimeler |
/diğer isimler | Araştırmacının bildiği diğer isimler |
/kişisel detaylar | Kişisel ayrıntılar: araştırmacının adı, kredi (yayınlanmış) adı ve biyografi |
/araştırmacı-url'leri | Araştırmacının kişisel veya profil sayfalarına bağlantılar |
/aktiviteler | Faaliyetler bölümünün özeti ORCID aşağıdaki /works dahil olmak üzere kaydedin. |
/eğitimler | eğitim bağlantıları |
/ istihdam | İstihdam bağlantıları |
/fonlar | Finansman faaliyetlerinin özeti |
/akran değerlendirmeleri | Hakem değerlendirmesi faaliyetlerinin özeti |
/İşler | Araştırma çalışmalarının özeti |
/ araştırma kaynakları | Araştırma kaynaklarının özeti |
/Hizmetler | Hizmetlerin özeti |
/ nitelikler | Niteliklerini özeti |
/üyelikler | üyelik özeti |
/ ayrımlar | Ayrımların özeti |
/davet edilen pozisyonlar | Davet edilen pozisyonların özeti |
Öğeler (işler, istihdam, finansman, akran değerlendirmesi vb.) ORCID manuel olarak veya kullanarak kaydedin ORCID üye API'si. Kaydınızı güncellemek isteyen bir kişiyseniz, Bununla ilgili yardım bölümü burada. Bir üyeye öğe eklemek istiyorsanız ORCID kaydetmek için aşağıdakilere ihtiyacınız olacak:
- araştırmacıların izni
- Üye API kimlik bilgileri
- Ya:
- ile entegre olan bir satıcı sistemidir. ORCID Üye API'sı
- ile entegre olan kendi sisteminizdir. ORCID Üye API'sı
Kayıt öğelerine yönelik API'yi kullanan üyelere yönelik eksiksiz bir kılavuz için aşağıdaki API eğitim bağlantımıza göz atın:
Bu örnek arama, tam bir özetini alır ORCID sanal alan sunucusundaki üye API'sini kullanarak XML biçiminde kaydedin. Genel veya Üye API'ye API istekleri yapmak için bir erişim belirtecine ihtiyacınız var.
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
API, isteğin başarıyla alındığını ve tam özetini belirten bir 200 OK mesajı döndürür. ORCID münferit öğelerin özetleri de dahil olmak üzere kayıt.
<?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>
Her öğenin (iş, finansman, istihdam vb.) kod koymak. Bu, gerekirse öğenin tüm ayrıntılarını elde etmek için kullanılabilir.
Sosyal bileşeni desteklemek için bir araç seti sunuyoruz. Sosyal Yardım Kaynakları entegrasyonunuzu desteklemek için bir kampanya geliştirmenize yardımcı olmak ve araştırmacılarınızla iletişim kurmak için:
- Ne ORCID olduğunu.
- Sisteminizin kimlikleri neden topladığı ve kayıtlarını güncellemek gibi görevleri nasıl gerçekleştireceği.
- Araştırmacılarınız neden bir ORCID iD ve kimliklerini sisteminize bağlama.
- Ne kadar ORCID daha geniş, küresel araştırma topluluğuna fayda sağlar.
Topluluktan gelen geri bildirimlere dayalı olarak bu kaynak "kütüphanesini" sürekli olarak oluşturacağız. Görmek isteyebileceğiniz bir şey için bir fikriniz varsa, lütfen bizimle iletişime geçmekten çekinmeyin.
Bir öğe ekleyebilmeniz için önce ORCID kaydında verilerinizi biçimlendirmeniz gerekecek ORCID şema. Verilerinizi şu şekilde biçimlendirin: ORCID XML veya JSON'da mesaj şeması.
GitHub depomuz, üzerinde yeni öğeler oluştururken biçimlendirmeye yardımcı olacak kaynaklar içerir. ORCID kaydedin ve cihazdaki mevcut öğeleri okurken ORCID kayıt:
API'nin farklı sürümlerinin farklı mesaj formatlarına sahip olduğunu unutmayın. Sürüm 2.0 ve 2.1 şemaları ve örnekleri de mevcuttur.
İyi doldurulmuş bir kaydın meta verilerini okuyarak daha fazla örnek kolayca bulunabilir.
Daha önceki sürüm ORCID API'nin ek kapsamları vardı. Bu kapsamlar, 2.0 API ile aşamalı olarak kaldırıldı. Tüm entegrasyonları yalnızca önerilen kapsamları kullanmaya teşvik ediyoruz. Başvuru için önceki kapsamlar, bunun yerine kullanılması gereken mevcut kapsamla birlikte aşağıda listelenmiştir.
- /orcid-profili/okuma-sınırlı onun yerine kullan / okuma sınırlı
- /orcid-works/okuma-sınırlı onun yerine kullan / okuma sınırlı
- /orcid-bio/okuma-sınırıd bunun yerine kullan / okuma sınırlı
- /orcid-works/oluştur onun yerine kullan /aktiviteler/güncelleme
- /orcid-works/güncelleme onun yerine kullan /aktiviteler/güncelleme
- /bağlantılar/oluştur onun yerine kullan /aktiviteler/güncelleme
- /bağlantılar/güncelleme onun yerine kullan /aktiviteler/güncelleme
- /finansman/yaratma onun yerine kullan /aktiviteler/güncelleme
- /finansman/güncelleme yerine /aktiviteler/güncelleme kullanın
- /orcid-bio/güncelleme onun yerine kullan /kişi/güncelleme
- /orcid-bio/harici-tanımlayıcılar/oluştur onun yerine kullan /kişi/güncelleme
Yenileme belirteçleri, ek erişim belirteçleri oluşturmak için kullanılır. Yetkilendirme kodunun bir parçası olarak değiş tokuş edilirken, erişim belirteciyle birlikte bir yenileme belirteci döndürülür. üç aşamalı OAuth işlemlerive erişim belirteci etkin kaldığı sürece kullanılabilir.
Yeni erişim belirteçleri, orijinal erişim belirteciyle aynı sona erme süresine ve kapsamlara sahip olabilir veya orijinal erişim belirtecinden daha kısa bir ömre ve daha küçük bir kapsam alt kümesine sahip olacak şekilde belirtilebilir. Orijinal belirteci değiştirmek için yeni erişim belirteçleri üretilebilir veya ek bir belirteç olarak hizmet vermek için üretilebilir. Orijinal erişim ve yenileme belirteçlerini ve kullanıcı tarafından verilen tüm izinleri tamamen sona erdirmek için yenileme belirteci çağrılarını da kullanabilirsiniz.
Aşağıdaki koşullarda yenileme belirteçlerini kullanmanızı öneririz:
- Güvenliği ihlal edilmiş olabilecek erişim belirteçlerini değiştirme (sonra orijinal erişim belirtecini iptal ettiğinizden emin olun.)
- Sizin de bir parçanız olan üçüncü bir tarafa vermek ORCID entegrasyon daha sınırlı erişim ve/veya sınırlı bir süre için erişim.
Bakın bizim teknik döküman yenileme belirteçlerinden yeni erişim belirteçlerinin nasıl oluşturulacağı hakkında.
Biri biyografik ayrıntılar, diğeri etkinlikler için olmak üzere iki farklı güncelleme kapsamı vardır.
kapsam | Açıklama | API uç noktaları |
/kişi/güncelleme | Biyografik veriler - sayfanın sol sütunu ORCID kullanıcı arabirimini kaydedin. | /adres /harici tanımlayıcılar /anahtar kelimeler /diğer isimler /araştırmacı-url'leri |
/aktiviteler/güncelleme | Araştırma faaliyeti verileri-sağdaki sütun ORCID kullanıcı arabirimini kaydedin. | / ayrım / ayrımlar /Eğitim /eğitimler /iş / istihdam /finansman /fonlar /davet edilen konum /davet edilen pozisyonlar /üyelik /üyelikler /akran değerlendirmesi /akran değerlendirmeleri /vasıf / nitelikler / araştırma-kaynak / araştırma kaynakları /hizmet /Hizmetler /iş /İşler |
Belirteç çiftini iptal etmek için müşteri kimliğinizi, sırrınızı ve etkin belirteci veya bununla ilişkili yenileme belirtecini kullanın. Hem iki ayaklı hem de iki ayaklı modda oluşturulan belirteç çiftlerini iptal edebilirsiniz. üç aşamalı OAuth işlemleri. Örneğin, farklı kapsamlar için birden fazla belirteç grubunuz varsa, yalnızca belirtilen erişim belirteci ve karşılık gelen yenileme belirteci iptal edilecektir.
Aşağıdaki koşullarda belirteçleri iptal etmenizi öneririz:
- Bir ilişkinin sona ermesinden sonra üçüncü taraf bir tedarikçiye verilen belirteçleri iptal etmek;
- Kullanıcılar bağlantılarını kestiğinde belirteçleri iptal etmek için ORCID iD sisteminizden;
- Kullanıcıların sisteminizden belirteçleri iptal etmesine izin vermek için.
Şunu kullanmanızı öneririz: jetonları yenile mevcut bir erişim belirtecinin kapsamını veya süresini sınırlamak veya güvenliği ihlal edilmişse bir belirteci güncellemek için.
API çağrısını iptal et
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]
Tüm öğeler (biyografi metni dışında) ORCID rekor var kod koymak:
<?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>
Bu yerleştirme kodu, bir öğenin tüm verilerini almak üzere API'ye çağrı yapmak için kullanılabilir. Aşağıdaki öğeler bir kullanılarak sorgulanabilir: kod koymak:
Son nokta | Açıklama |
/adres/[kodu girin] | Tek bir ülke veya bölge |
/biyografi | Biyografi alanı: yalnızca araştırmacının düzenleyebileceği serbest metin alanı |
/eğitim/[kodu girin] | Bireysel bir eğitim bağlantısı öğesi |
/email/[kodu girin] | Kayıtla ilişkili bireysel bir e-posta adresi |
/istihdam/[kodu girin] | Bireysel istihdam ilişkisi öğesi |
/harici tanımlayıcı/[kodu girin] | Başka bir sistemdeki bireysel bağlantılı harici tanımlayıcı |
/finansman/[kodu girin] | Bireysel finansman faaliyeti |
/keywords/[kod girin] | Araştırmacı ve çalışmaları ile ilgili bireysel bir anahtar kelime |
/diğer isimler/[kodu girin] | Araştırmacının bildiği ayrı bir ek isim |
/peer-review/[kodu girin] | Bireysel akran değerlendirmesi etkinliği |
/araştırmacı-urls/[kodu girin] | Araştırmacının kişisel sayfasına veya profil sayfasına tek bir harici bağlantı |
/work/[kodu girin] | Bireysel araştırma çalışması |
/works/[kod1 girin],[kod2 girin],[kod3 girin] | Toplu bireysel araştırma çalışmaları (100'e kadar) |
Bölüm uç noktasını ve kod koymayı kullanarak, söz konusu öğeyi tam olarak almak için aynı erişim belirtecinizi kullanarak API'yi çağırabilirsiniz. Bu örnek çağrı, korumalı alan sunucusundaki üye API'sini kullanarak tam finansman kalemi 4413'ü XML biçiminde alır.
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
API, mesajın başarıyla alındığını belirtmek için bir 200 OK mesajı döndürür ve finansman öğesinin tam XML'sini döndürür:
<?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>
Kontrol edebilirsiniz bir öğenin kaynağı Okurken kimin eklediğini bilmek istiyorsanız.
Yaygın API hata kodlarının bir listesi, olası anlamları ve bunların nasıl giderileceğine ilişkin ipuçları, sayfamızda mevcuttur. teknik döküman.
Yaşadığınız sorunu çözemezseniz lütfen bize bildirin.
ORCID üyeler daha önce ekledikleri bilgileri güncelleyebilir ORCID kayıt. Aynı anda yalnızca bir öğe güncellenebilir ve yalnızca onu en başta oluşturan istemci kimlik bilgileri kullanılarak güncellenebilir.
Güncellemeyi kolaylaştırmak için, koyma kodunu ve erişim belirtecini saklayın öğeleri oluştururken.
Güncellenen öğeyi biçimlendir in ORCID mesaj şeması değiştirilen bilgilerle ve saklanan bilgileri içerir kod koymak.
<?xml version="1.0" encoding="UTF-8"?> <employment:employment put-code="739288" [...]> [...] </employment:employment>
API'yi arayın:
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
API, öğenin doğru şekilde güncellendiğini belirtmek için bir 200 OK mesajı döndürür. Farklı bir mesaj döndürülürse sorun giderme sayfamızı kontrol edin.
Görünürlük, kullanıcının belirlediği görünürlük tercihine bağlı olarak öğenin gizlilik ayarını gösterir. API aracılığıyla bilgi gönderildiğinde bir görünürlük etiketi dahil edilirse, dikkate alınmaz. Bunun yerine bilgiler, kullanıcının hesap tercihlerinde ayarlanan varsayılan görünürlük tercihine göre yayınlanacaktır.
Herkese açık öğeler, API aracılığıyla herkes tarafından okunabilir ve araştırmacının genel kaydında gösterilir, Güvenilir taraf öğeleri, yalnızca okuma sınırlı erişimi olan müşterilere API aracılığıyla döndürülür; araştırmacının kamuya açık kayıtlarında yer almazlar. Özel öğeler yalnızca araştırmacı ve öğenin kaynağı tarafından görülebilir – API aracılığıyla döndürülen özel öğeler yalnızca, sizin entegrasyonunuz yoluyla kayda eklenenlerdir. Görünürlük ayarları hakkında daha fazla bilgi için bkz. ORCID Kayıt (uzun süredir Amerika'da belgesi olmadan ikamet eden kişiler için).
Öğeler (işler, istihdam, finansman, akran değerlendirmesi vb.) ORCID kullanarak kayıt ORCID üye API'sı. Bunu yapmak için önce yapmanız gerekenler OAuth kullanarak araştırmacıdan izin almak ve öğe meta verilerini biçimlendir ile ORCID mesaj şeması.
Verileri biçimlendirdikten ve verileri topladıktan sonra ORCID iD ve erişim belirteci, belirterek, HTTP POST kullanarak bir API isteği yaparsınız. ilgili uç nokta.
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şağıdaki çağrı yeni bir ekler iş korumalı alan test sunucusundaki bir kayda bağlılık:
<?xml version="1.0" encoding="UTF-8"?>
<employment:employment [...]>
[...]
</employment:employment>
API, öğenin öğeyle birlikte doğru şekilde gönderildiğini belirtmek için bir 201 mesajı döndürür. kod koymak. Müşteriniz şu şekilde listelenecektir: öğenin kaynağı.
Kontrol edin sorun giderme sayfa farklı bir mesaj döndürülürse. kaydetmeniz gerekecek koyma kodunu ve erişim belirtecini saklayın herhangi bir güncelleme yapmak veya öğeyi kaldırmak için.
The ORCID arama API'si SOLR sözdizimini kullanır. SOLR 3.6'da bulunan tüm sorgu sözdizimleri desteklenir, Solr uzantılı Lucene dahil (Varsayılan), DisMax ve Genişletilmiş Dismax.
Bunu kullanmak için bir "/read-public" erişim belirtecine ihtiyacınız var. Arama jetonunuzu aldıktan sonra temel arama URL'nizi oluşturun:
Kimlik bilgileri türü: | Genel API | Üye API'sı |
Kaynak URL'si: | Kum havuzu: https://pub.sandbox.orcid.org Yapım: https://pub.orcid.org | Kum havuzu: https://api.sandbox.orcid.org Üretim: https://api.orcid.org |
API sürümü: | v3.0 | |
Uç nokta ara | /arama/?=[sorgu] |
Sandbox genel API'sinde belirteçle "orcid" araması yapmak için bir örnek çağrı, sonuçları XML biçiminde döndürür:
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
Sonuçlar, bulunan sonuçların sayısını (bulunan sayı) belirtir ve varsayılan olarak ilk 1000 sonucu görüntüler:
<?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>
Korumalı alan genel API'sinde sonuçların json biçiminde döndürüldüğü örnek bir temel arama:
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
Arama yalnızca kişiyi döndürür ORCID Aramayla eşleşen genel verileri tutan kayıtların kimlikleri. Sonuç hakkında daha fazla bilgi edinmek için, bir arama yapın ve okuyun. ORCID doğrudan kaydedin.
Daha fazla bilgi için, bkz bizim Arama API'si öğreticisi.
Silinmesi gereken veriler eklediyseniz, örneğin yanlış dosyayla ilişkilendirilmişse. ORCID iD, ardından bir HTTP DELETE isteği yapabilirsiniz. ilgili uç nokta, ile birlikte ORCID İD, saklanan erişim belirteci ve saklanan koyma kodu. Bir seferde yalnızca bir öğe silinebilir ve siz yalnızca müşteriniz tarafından eklenen öğeleri silebilirsiniz. Kullanıcı izni iptal etmiş olsa bile öğeleri silebilirsiniz.
Bu örnek arama, “739288” kodlu istihdam öğesini bir kayıttan siler”
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
The ORCID arama API'si SOLR sözdizimini kullanır. SOLR 3.6'da bulunan tüm sorgu sözdizimleri desteklenir, Solr uzantılı Lucene dahil (Varsayılan), DisMax ve Genişletilmiş Dismax.
Belirli bir bölümü aramanız gerektiğinde, alanlı aramayı kullanabilirsiniz. ORCID kayıt. API aramasında tanınan alanların mevcut listesi, karşılık gelen kayıt yapısı öğeleriyle birlikte aşağıdaki gibidir:
Arama alanı | Açıklama |
Biyografik veriler | |
Lakaplar | Kullanıcının verilen (ilk) ad(lar)ı. |
soyadı | Kullanıcının soyadı (soyadı). |
kredi adı | üzerinde “yayınlanan isim” ORCID kullanıcı arabirimi, normalde kullanıcı tarafından yayınlarda görünen ad |
diğer isimler | Kullanıcı tarafından yayınlarda yer almış olabilecek alternatif isimler. |
E-posta | Kullanıcının e-posta adresi. |
Anahtar kelime | Kullanıcıyla ilişkili tüm anahtar kelimeler. |
harici kimlik referansı | Kullanıcı bilgilerine eklenen diğer sistemlerden tanımlayıcılar ORCID API kullanarak kaydedin. |
Bağlantı verileri | |
üyelik-kuruluş-adı | Kullanıcı kaydındaki bir eğitim veya istihdam öğesindeki herhangi bir kuruluşun adı. |
grid-org-id | The IZGARA KIMLIĞI Kullanıcı kaydının etkinlikler bölümündeki herhangi bir kuruluşun. Genellikle bu, bir eğitim veya istihdam öğesiyle ilişkilendirilir. |
ror-org-kimliği | The ROR kimliği Kullanıcı kaydının etkinlikler bölümündeki herhangi bir kuruluşun. Genellikle bu, bir eğitim veya istihdam öğesiyle ilişkilendirilir. |
ringgold-org-kimliği | The Ringaltı kimliği* Kullanıcının kaydının etkinlikler bölümündeki herhangi bir kuruluşun. Genellikle bu bir eğitim veya istihdam öğesiyle ilişkilendirilecektir. |
Finansman verileri | |
finansman başlıkları | Kullanıcının kaydındaki herhangi bir finansman öğesinin başlığı. |
fonref-org-kimliği | The Crossref Fon Sağlayıcı Kayıt Kimliği bir kullanıcı kaydının etkinlikler bölümündeki herhangi bir kuruluşun. Genellikle bu, bir finansman öğesiyle ilişkilendirilir, ancak aynı zamanda bir üyelikle de ilişkilendirilebilir. |
hibe numaraları | Kullanıcı kaydındaki herhangi bir finansman kaleminin hibe numarası (tanımlayıcı). |
Araştırma faaliyetleri verileri | |
iş başlıkları | Kullanıcının kaydındaki herhangi bir çalışmanın başlıkları. |
dijital nesne kimlikleri | doi tipinde bir iş harici tanımlayıcısı |
kendi kendine | doi türünde bir iş dış tanımlayıcısı ve dış tanımlayıcı ilişkisi self olarak ayarlanmış |
[harici tanımlayıcı türü]* | Belirtilen türde bir iş harici tanımlayıcısı |
[harici tanımlayıcı türü]*-self | Verilen tür ve dış tanımlayıcı ilişkisi self olarak ayarlanmış bir iş harici tanımlayıcısı |
[harici tanımlayıcı türü]*-part-of | Verilen tür ve dış tanımlayıcı ilişkisi part-of olarak ayarlanmış bir iş harici tanımlayıcısı |
[harici tanımlayıcı türü]*-versiyon-of | Verilen tür ve dış tanımlayıcı ilişkisinin version-of olarak ayarlandığı bir iş harici tanımlayıcısı * Harici tanımlayıcının tam listesi için bkz. tanımlayıcılar listesi. Bazı tanımlayıcılar, sonuçları döndürmek için "-self", "-part-of" veya "-version-of" gerektirebilir |
ORCID kayıt verileri | |
orcid | 16 basamaklı ORCID kullanıcı tanımlayıcısı, 0000-0001-2345-6789 biçiminde. |
profil gönderme tarihi | Kaydın oluşturulduğu tarih ve saat. |
profil-son-değiştirme-tarihi | Kaydın en son değiştirildiği tarih ve saat. |
Bütün bilgiler | |
metin | Yukarıdaki tüm alanlar. Bu aynı zamanda Lucene sözdizimi sorguları için varsayılan alandır. |
Our bakın Arama API'sı Eğitimi daha fazla bilgi için.
*Ringgold tanımlayıcıları hala mevcut olmasına rağmen ORCID 1 Ağustos 2023 itibarıyla kayıt, ORCID artık Kayıt Kuruluşumuz tarafından kullanılan RINGGOLD kuruluş tanımlayıcı veritabanına ilişkin güncellemeleri almayacak ve bu tarihten sonra oluşturulan RINGGOLD Kimliklerini işleyemeyecek veya kullanamayacağız. Bizimkilere bakın SSS daha fazla bilgi için
Gerçek dünyadaki durumlarda, API etkileşimleri sisteminiz tarafından PHP, Java veya Ruby on Rails gibi bir programlama dili kullanılarak tamamlanır. Alıştırma ve test için, ORCID HTTP istekleri oluşturabilen ve alabilen bir dizi araç kullanan API'ler. Çoğu masaüstü HTTP aracı komut satırında çalıştırılır; grafik arayüzü tercih edenler için web tabanlı araçlar faydalı bir alternatiftir.
XML/XSD DOĞRULAMASI
XML'inizi sizin için doğrulayacak birçok araç vardır; birini benimsemek iyi bir fikirdir. API çağrılarının çoğu için, XML biçimli bilgilerle çalışacaksınız. ile çalışırken özellikle ORCID API Mesajı, kullandığınız XML'in XSD'ye karşı geçerli olması önemli olacaktır. (bkz. bizim GitHub'daki belgeler için ORCID mesaj şeması XSD.)
ORCID SANDBOX TEST SUNUCUSU
The korumalı alan test sunucusu bir kopyasıdır ORCID Kayıt defteri yazılımıdır ve yalnızca test verilerini içerir. Gerçekleri etkilemeden bir şeyleri denemek için bir yer sağlamak için tasarlandı. ORCID kimliklerle çalışıyorsanız, özellikle ORCID API ve çalışmanızı test etmek için bir yere ihtiyacınız var. Üretim verilerini etkileme veya yanlışlıkla araştırmacılara spam gönderme konusunda endişelenmenize gerek kalmadan, kullanıcı hesapları oluşturabilir ve korumalı alanda API çağrılarını test edebilirsiniz.
olmana bile gerek yok ORCID üye API'sini sanal alanda denemek için üye. Herkes korumalı alan üye API kimlik bilgilerini talep edebilir ve üye API'sinin sunduğu tüm özellikleri deneyebilir.
Site ve API'ler, üretim sunucuları kadar güvenilir olmayacaktır. Korumalı alandaki veriler hakkında hiçbir garanti vermiyoruz; yedeklenmezler ve silinebilirler. Korumalı alan, henüz üretim sunucularında olmayan bazı deneysel işlevler de içerebilir, böylece bunları Kayıt Defterinde bulunmadan önce deneyebilirsiniz. Devamını okuyunuz korumalı alan test sunucusu hakkında veya müşteri kimlik bilgilerini iste.
HTTP ARAÇLARI
HTTP isteklerini çalıştırmak için birçok araç mevcuttur. Kullandığımız bazıları:
Web kancaları, premium üyeler tarafından herhangi bir kişiye karşı kaydedilebilir. ORCID kayıt defterine kaydedin. Adımlar:
URL'yi kodlayın
İstediğiniz URL'yi URL kodlaması ORCID kullanıcının kaydı güncellendiğinde aramak için. Örneğin aşağıdaki URL:
https://nowhere2.com/0000-0002-7465-2162/updated
olur
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
URL'yi oluşturun
Şunun için tam URL'yi oluşturun: ORCID URL'si ile başlayan API çağrısı ORCID ardından ‚√∫/webhook‚√π ve çağrılmasını istediğiniz URL'yi ekleyin. Yani https://api.sandbox.orcid.org/{ gibi görünmelidirORCID}/webhook/{URL-KODLANMIŞ-WEBHOOK-URL}
Örneğin, yukarıdaki webhook URL'sini ve ORCID iD 0000-0002-7465-2162, tam URL:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
webhook'u kaydettirin
Webhook'unuzu kullanıcılara karşı kaydetmek için webhook erişim belirtecinizi kullanın. ORCID kayıt. Bir HTTP PUT isteği kullanmanız gerekir, ancak isteğin gövdesine hiçbir şey eklememelisiniz.
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
Yanıt bir 201 olmalıdır, ancak geri arama zaten mevcutsa yanıt 204 olacaktır.
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
Bir webhook'un kaydını silme URL'si, kaydolma URL'si ile aynıdır. Ancak, HTTP DELETE yöntemini kullanmanız gerekir.
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
Yanıt şu olmalıdır: 204 No Content
.
HTTP/1.1 204 No Content
Server: Apache-Coyote/1.1
Date: Fri, 05 Apr 2013 12:49:17 GMT
The ORCID Bir kayıt güncellendiğinde kayıt defteri aşağıdaki HTTP çağrısını yapacaktır. İstek, HTTP POST yöntemini kullanıyor ancak isteğin gövdesi boş.
curl -v -X POST https://nowhere2.com/0000-0002-7253-3645/updated
Sunucunuz standart HTTP yanıt kodlarıyla yanıt vermelidir. Bu nedenle, arama başarılı olursa 204 No Content döndürmelisiniz.
HTTP/1.1 204 No Content
Herhangi bir 2xx yanıt kodu, aramanın başarılı olduğu anlamına gelir. 2xx olmayan bir kod döndürürseniz, aramayı beş dakika sonra yeniden deneyeceğiz.
Gerçek dünyadaki durumlarda, API etkileşimleri sisteminiz tarafından PHP, Java veya Ruby on Rails gibi bir programlama dili kullanılarak tamamlanır. Bununla birlikte, uygulama ve test için, ORCID HTTP istekleri oluşturabilen ve alabilen bir dizi araç kullanan API. Çoğu masaüstü HTTP aracı (örneğin cURL) komut satırında çalıştırılır; grafik arayüzü tercih edenler için web tabanlı araçlar faydalı bir alternatiftir.
Popüler bir araç Google'ın OAuth 2.0 Oyun Alanı, Google tarafından geliştirilen ve sürdürülen ücretsiz, web tabanlı bir araç.
Lütfen API eğitimimizi şu adreste inceleyin: https://info.orcid.org/hands-on-with-the-orcid-api/
Not: ORCID OAuth 2.0 Oyun Alanının bakımını yapmaz – bu araç, kodunun bakımını özel olarak yapan Google tarafından oluşturulmuştur. Bu belgeleri periyodik olarak güncellesek de, OAuth 2.0 Playground'daki değişikliklerden hemen haberdar olamayabileceğimiz için zaman zaman bazı yanlışlıklar olabilir.
ORCID Kullandığınız API'ye bağlı olarak farklı API kullanım kotası ve oran sınırlarını destekler.
API | Anonim API | Genel (kayıtlı) API | Üye API'sı |
Oran Sınırı | 12 req/sn40 patlama/sn | 12 req/sn40 patlama/sn | 24 req/sn40 patlama/sn |
Kullanım Kotası | 25 bin okunma/gün (IP adresi başına) | 100 bin okunma/gün (Müşteri Kimliğine göre) | Kullanım Kotası Yok |
Bir saniye talep ediyor saniyede yapılabilecek istek sayısıdır.
patlamaları reddetmeden önce kuyruğa alınmasına izin vereceğimiz istek sayısıdır. Kuyruktaki istekler saniye başına istek hızına yavaşlatılır. Patlamayı aşarsanız, 503 yanıtı alırsınız.
Kullanım kotasını aşmanız durumunda, belirtilen süre içerisinde daha fazla talepte bulunmanız engellenecektir.
Lütfen şunu unutmayın: ORCID Genel API, bireyler tarafından ticari olmayan kullanım için, belirtildiği gibi ücretsizdir. Genel API'ler Hizmet Şartları"Ticari olmayan" ifadesiyle, Genel API için herhangi bir yeniden kullanım ücreti talep edemeyeceğinizi ve Genel API'yi herhangi bir gelir getirici ürün veya hizmetle bağlantılı olarak kullanamayacağınızı kastediyoruz.
İstemci kimlik bilgileriyle Genel API'yi kullanmak, anonim API'den daha yüksek bir kullanım kotasını bütünleştirmenize olanak tanır. Lütfen şuraya bakın: entegrasyon kılavuzu Genel bir API istemcisinin nasıl kaydedileceği hakkında.
Genel API için API kullanım kotasını düzenli olarak aşıyorsanız, bir API olmayı düşünmenizi öneririz. ORCID erişim için üye Üye API'sı. Sadece daha yüksek bir oran sınırına ve kısıtlanmamış bir kullanım kotasına erişmenize izin vermekle kalmayacak, aynı zamanda Güvenilir Taraf verilerine de erişebileceksiniz. ORCID kayıtlar ve veriye katkıda bulunmak ORCID Kullanıcıların izniyle kurumsal sistemlerinizden kayıt alabilirsiniz.
Araştırmacı kontrolü bir çekirdektir ORCID prensip e-posta adresleri kaydedildi ve eklendi ORCID kayıt, varsayılan olarak yalnızca kayıt sahibi tarafından görülebilir şekilde ayarlanmıştır. Doğrulanmamış e-postalar, kaydın genel görünümünde görüntülenmez ve API sonuçlarında yalnızca doğrulanmış e-posta adresleri görünür.
Araştırmacılar e-posta adreslerini doğruladıktan sonra, e-posta adresinin üçüncü taraf kuruluşlar tarafından okunabilmesi için herkes (ör. herkese açık) veya güvenilen taraflar (yani sınırlı erişim) tarafından görünür kılmayı seçmelidirler.
Araştırmacı, e-posta adresini Güvenilir Taraflar olarak ayarlamışsa, araştırmacı size izin vermişse, kayıtla birlikte iade edilecektir. okuma sınırlı erişim. Daha fazla bilgi için bakınız ORCID görünürlük ayarları.
API 3.0, varsayılan API sürümüdür ve yeni entegrasyonlar oluştururken bu sürümü kullanmanızı öneririz. Öngörülebilir gelecekte API 2.0 ve 2.1'i desteklemeye devam edeceğiz ve bu sürümleri kapatmadan önce en az 12 ay önceden bildirimde bulunacağız.
API 1.2'den API 2'ye geçiş sırasında çok şey öğrendik. Bu sefer yükseltmeyi yönetmeyi çok daha kolay hale getirdik. API 3.0, yalnızca kesinlikle gerekli olduğunda mevcut işlevleri değiştirirken yeni işlevler ekler. Bu, entegratörlerin en az zahmetle yeni API'ye geçebilmesi gerektiği anlamına gelir. Ayrıca, kuruluşunuzun ve araştırmacılarınızın yeni özelliklerden yararlanabilmesi için yükseltmenizi mümkün olan en kısa sürede planlamaya başlamanızı önersek de, 3.0'a ne zaman güncelleme yapacağınıza karar verme konusunda çok fazla esnekliğe sahip olduğunuz anlamına gelir.
Potansiyel olarak yıkıcı değişikliklerin küçük listesi, API sürüm notlarımızdadır. okuyun ve okuyun. İsteğe bağlı/zorunlu alanlar etrafında birkaç değişiklik var, JSON numaralandırmaları biraz değiştirildi ve ayrıca XML şemalarımızda küçük bir yeniden düzenleme yaptık, yeni işlevsellik için gerekli meta verileri içerecek bazı yeni alanlar ekledik.
Bakın ORCID yayıncılar için satıcı tarafından etkinleştirilen sistemler sayfası en güncel bilgiler için
Herhangi bir premium üye bir '/webhook' erişim belirteci alabilir. Birden çok kayıt için web kancalarını kaydetmek için tek bir belirteç kullanılabilir. Bir belirteç almak için, ORCID API belirteci bitiş noktası.
Bu işleme genellikle istemci kimlik bilgileri OAuth akışı veya 2 adımlı OAuth denir.
Aşağıda, erişim belirtecini almak için örnek bir çağrı verilmiştir - yer tutucuları kimlik bilgilerinizle değiştirin (parantezleri çıkardığınızdan emin olun.)
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"
Daha sonra size aşağıdakine benzer bir erişim belirteci iade edilecektir.
{"access_token":"5eb23750-1e19-47a3-b6f6-26635c34e8ee",
"token_type":"bearer",
"refresh_token":"c7d3d5fd-e4c0-4825-89f2-7cfb4a1cf01e",
"expires_in":631138518,
"scope":"/webhook"}
Evet yaparız! API versiyonlamamız, arkasındaki mantık ve daha fazlası hakkında daha fazla bilgiyi burada, bizim sayfamızda bulabilirsiniz. API Sürüm Politikası.
Ürünlerimizi geliştirmeye devam ederken, yalnızca en son ve varsayılan API sürümümüz olan API 3.0 ile kullanılabilen bir dizi özellik bulunmaktadır.
Aşağıdaki tablo, her özelliğin kısa bir açıklamasını sağlar. Özelliklerden herhangi biriyle veya 3.0'a yükseltmeyle ilgili herhangi bir sorunuz varsa, lütfen Etkileşim Lideriniz veya Konsorsiyum Lideriniz ile iletişime geçin.
Tüm üyelik türlerini okuyabilme ve yazabilme (üyelik, hizmet, davet edilen pozisyonlar, ayrımlar ve nitelikler API'nin önceki sürümlerinde mevcut değildir) |
Araştırma Kaynaklarını okuma ve yazma becerisi. |
'Funded By' ilişki türüyle iş tanımlayıcılarını okuma ve yazma yeteneği. Bu, Hibe veya Teklif Kimliklerini çalışma meta verilerine bağlamak için kullanılır. |
'Sürüm' ilişki türüyle iş tanımlayıcılarını okuma ve yazma yeteneği. Bu, çalışmanın diğer sürümlerini birbirine bağlamak için kullanılır. Örnek bir kullanım durumu, ön baskı ile yayınlanan makale arasında bağlantı kurmak olabilir. |
İş meta verileri içinde CRediT rollerini okuma ve yazma becerisi. |
Ek kaynak alanlarını okuyabilme common:onay-kaynak-istemci-kimliği ve common:iddia-kaynak-adı tarafından eklenen üyelikler için ORCID üye portalı ve arama ve bağlantı sihirbazları tarafından eklenen çalışmalar. |
Okuma ve yazma becerisi, aşağıdaki iş türleri ile çalışır: not Blog yazısı kartografik-malzeme klinik çalışma konferans çıktısı konferans sunumu konferans bildirileri veri yönetimi planları dizayn Bitirme tezi görüntü hareketli görüntü müzik-kompozisyonu ön baskı fiziksel nesne kamusal konuşma ses transkripsiyon yorum |
Bağlantılar için harici kimlikleri okuma ve yazma yeteneği. |
Üyelikler eklemek ve fon sağlamak için kuruluş kimlikleri zorunludur ORCID Kayıtlar. |
Tanımlayıcıları Biçimlendirme – Eşleştirme ve gruplandırma amacıyla harici tanımlayıcıları (DOI'ler, PMCID, PMID, ArXiv, Bibcode, ISSN'ler ve ISBN'ler) normalleştirilmiş bir biçimde ifade eden, sistem tarafından oluşturulmuş yeni bir alanı kullanıma sunduk. Normalleştirme, tanımlayıcı türünün kurallarına göre yapılır ve tüm alfa karakterlerini küçük harfe ayarlamayı veya boşlukları, tireleri, noktaları ve eşdeğer olarak değerlendirilebilecek diğer karakterleri dönüştürmeyi içerebilir. Ayrıca uygun şekilde standart önekler ve sonekler ekler. Örneğin, https://doi.org/10.1/123, 10.1/123, ve https://dx.doi.org/10.1/123 hepsi bu alanda şu şekilde görünecek: https://doi.org/10.1/123. Mevcut tanımlayıcı değeri değiştirilmemiştir. |
Daha detaylı bilgi bulunabilir okuyun.
Diğer
Telefonlarında bir bildirim alırlar. ORCID gelen kutusu. Bir veride herhangi bir değişiklik olduğunda ORCID kullanıcı, güncellemeyi gerçekleştiren istemcinin adı, değişiklik tarihi ve kayıttaki öğe dahil olmak üzere değişiklikle ilgili temel bilgileri içeren bir bildirim alır. ORCID güncellenen kayıt. bizim görmek bildirimler hakkında daha fazla bilgi için kullanıcı Bilgi Bankası.

ORCID korumalı alandaki kayıtlarda ayrıca çalışan gelen kutuları. Testinizin gelen kutularına düzenli olarak bakmanızı öneririz. ORCID sistemlerinizin veri güncellemelerini nasıl planlayacağını planlarken kaydeder.
API kullanıcılarına yönelik güncellemeler ve diğer duyurular, ORCID API Kullanıcıları Grubu. Ayrıca genel mesajlara ve güncellemelere abone olabilirsiniz. ORCID Blog.
ORCID üyeler ayrıca ORCID Bu bilgilerin yer aldığı Üye Bülteni. Son olarak, herhangi bir teknik iletişim için ORCID aktif, özel olarak oluşturulmuş bir entegrasyona sahip üye, aynı zamanda herhangi bir kritik güncelleme hakkında e-posta mesajları alacaktır. ORCID Kayıt. Kuruluşunuz için teknik iletişim sorumlusu olarak listelenmek istiyorsanız, lütfen İletişim.
ORCID açık ve şeffaf olmayı taahhüt eder. Bu bizim anlamına gelir Ürün yol haritası olduğu gibi, herkesin görüntülemesi için kullanılabilir. şu anda geliştirilmekte olan iş.
Ürün Yol Haritası, ORCID ürün geliştirme süreci. Gereksinimler, ekip tarafından yönetilen trello panolarından, Ürün Yol Haritası trello panosuna ve devamında, uygulandıkları ve üretim sistemlerimize taşındıkları Güncel Geliştirme trello panosuna gider.
Bu pano, uygulanması planlanan iyi tanımlanmış gereksinimler içerir bir noktadave yakın dönemde uygulanması planlanan öncelikli gereksinimlerin bir listesi.
Gereksinimler nereden geliyor?

Gereksinimler tarafından birçok kaynaktan toplanır ORCID kadro. Diğerlerinin yanı sıra üye istekleri, konsorsiyum geri bildirimi, kullanıcı testi, stratejik projeler ve hata raporlarından kaynaklanabilirler. Ayrıca, tüm ORCID ekipler, web sitesi değişiklikleri, altyapı yükseltmeleri ve operasyonel sistem güncellemeleri gibi kendi dahili gereksinimlerini oluşturur. Her kart, gereksinimi oluşturan ekiple (iletişim, strateji, teknoloji, katılım veya operasyonlar) etiketlenir.
Yol haritasında işler nasıl gidiyor?
ORCID dengeli bir ürün geliştirme döngüsü hedefler ve yakın ve uzun vadeli öncelikleri tartışmak için düzenli olarak ekipler arası toplantılar düzenler. Hataları, yeni özellikleri, teknik borçları, web sitesi güncellemelerini ve stratejik öğeleri eşit şekilde ele almak için elimizden gelenin en iyisini yapıyoruz.
Yol haritasına nasıl katkıda bulunabilirim?
nasıl iyileştirilebileceğine dair önerileri memnuniyetle karşılıyoruz. ORCID kayıt. Lütfen herhangi bir geri bildirim gönderin bizim takım.
Ek olarak, ORCID açık kaynaklı bir projedir ve kaynak kodumuza ve diğer tüm katkılara açığız. depolarımız.
Ön baskı, yazarlar tarafından bir genel sunucuya yüklenen eksiksiz bir bilimsel el yazmasıdır. Ön baskı, tüm verileri ve metodolojileri içerir; genellikle bir dergiye gönderilen aynı el yazmasıdır. Çalışmanın doğası gereği bilimsel olduğundan emin olmak için yapılan kısa bir kalite kontrol denetiminden sonra, yazarın el yazması, emsal değerlendirmesi olmaksızın bir veya daha fazla gün içinde Web'de yayınlanır ve dünyadaki herkes tarafından ücretsiz olarak görüntülenebilir. Geri bildirim ve/veya yeni verilere dayalı olarak, ön baskınızın yeni sürümleri gönderilebilir; ancak önceki ön baskı sürümleri de korunur. Ön baskı sunucuları, bilim adamlarının çalışmalarının dünya çapındaki bilim topluluğuna yayılmasını doğrudan kontrol etmelerine olanak tanır. Çoğu durumda, ön baskı olarak yayınlanan aynı çalışma aynı zamanda bir dergide akran değerlendirmesi için gönderilir. Bu nedenle, ön baskılar (hızlı, ancak akran değerlendirmesi yoluyla doğrulanmamış) ve dergi yayını (yavaş, ancak akran değerlendirmesi kullanılarak doğrulama sağlayan) bilimsel araştırma için bir iletişim sistemi olarak paralel çalışır.
Not: Bu içerik ve video ilk olarak ASAPBio web sitesi Bunu bir CC-BY Lisansı altında kullanıma sunduğu için ASAPBio'ya teşekkürler!
Aylık olarak gönderilen üye bülteni ORCID daha önce tüm üye raporlarınızın saklandığı bir Google Drive klasörüne bağlantı içeriyordu. Bu, artık tüm üyelerin kullanabileceği yeni raporlarla değiştirilmiştir. üye portalı.
Önceki raporlar:
- Aktif entegrasyonlara sahip premium üyeler önceki aydaki her entegrasyon için verileri içeren ayrı, özelleştirilmiş raporları içeren bir klasöre benzersiz bir bağlantı alırsınız.
- Henüz aktif entegrasyonu olmayan premium üyeler kurumları için e-posta istatistikleri içeren özelleştirilmiş raporlar içeren bir klasöre benzersiz bir bağlantının yanı sıra tüm aktif üye entegrasyonları için toplu veriler içeren genel raporları içeren bir klasöre bir bağlantı alırsınız.
- Temel üyeler önceki altı ayda tüm aktif üye entegrasyonları için birleştirilmiş verilerle yılda iki kez yayınlanan genel raporları içeren bir klasöre bağlantı almak; yılın ilk yarısı raporunun yayınlanması Temmuz (Ocak-Haziran verileri), yılın ikinci yarısında yayınlanan rapor Ocak (ertesi yılın Temmuz-Aralık).
Eğer varsa ORCID üyesiyseniz ve şu anda aylık üye bültenini almıyorsanız, lütfen iletişime geçin [e-posta korumalı]
Aktif entegrasyonlara sahip premium üyeler
Google Drive klasörü, size verilen üretim istemci kimliklerinin her biri için bir üye raporu içerir. Dosya adları, istemcinin görünen adını içerir iD ve raporun tarihi; en son raporu bulmak için lütfen değiştirilme tarihine göre sıralayın. Raporu oluşturmak için kullanılan verileri içeren ve gerekirse ek analiz için kullanılabilen bir raw_data klasörü de vardır.
Henüz aktif entegrasyonu olmayan premium üyeler
Google Drive klasörü, yalnızca e-posta istatistik verilerini içeren bir üye raporunun yanı sıra, mevcut ve önceki yıllar için tüm aktif üye entegrasyonları için birleştirilmiş verileri içeren genel aylık raporları içeren bir Google Drive klasörüne bağlantı içerir. Bu raporlar için ham veriler mevcut değildir.
E-posta etki alanı sayısı
Bu bölüm, ORCID iD'ler şu anda kurumunuzun e-posta etki alan(lar)ını tüm zaman dilimlerinde kaydetmiştir. Bu sayıları oluşturmak için, kuruluşunuz için dosyamızda bulunan web sitesi URL'siyle eşleşen alanları ararız (ör. web sitenizin URL'si www.universitycollege.edu ise, @universitycollege ile biten e-postaları ararız). Kayıtlı bir web sitesi URL'miz yoksa, bu bölümde ‚√∫E-posta etki alanı sağlanmadı‚√π ifadesini göreceksiniz. E-posta alan adınızı tam olarak doğru bulamadıysak veya ek alan adları eklemek istiyorsanız, lütfen İletişim.
- E-posta etki alanlarınıza kayıtlı kayıtlar¬¨‚Benzersiz sayı ORCID Kurumunuzun e-posta alan(lar)ında bir adres içeren kimlikler
- E-posta etki alanlarınıza kayıtlı VE müşteri kimliğinizle ilişkili kayıtlar¬¨‚Benzersiz sayı ORCID Kurumunuzun e-posta alan(lar)ında bir adres içeren VE kurumunuzu Güvenilir Taraf olarak içeren kimlikler (yani: kurumunuzun geçerli bir erişim belirtecine sahip olduğu kayıtlar)
Oluşturulan ve talep edilen kayıtlar
(Not: çoğu müşterinin raporlarında bu bölüm olmayacaktır)
API aracılığıyla araştırmacılar adına kayıt oluşturmak için kullanılan bir kurumsal müşteriniz varsa, Kayıt İstatistikleri adlı bir bölüm alacaksınız. Buna, oluşturduğunuz kayıt sayısı ve talep edilen kayıt sayısı da dahildir (raw_data dosyası, bu sayıları oluşturmak için kullanılan belirli kayıtlar hakkında daha fazla bilgi içerir).
Kullanıcılar
Raporun bu bölümü, entegrasyonunuzu kullanan araştırmacı sayısının toplam sayısını içerir. ORCID iD raporlama ayı boyunca sisteminize. Ayrıca, yeni bir sisteme kaydolan araştırmacıların toplam sayısını verir. ORCID iD bir parçası olarak iD bağlantı süreci.
Toplam Entegrasyon Olayları etiketli grafik, geçen ay entegrasyonunuzu kullanan araştırmacı sayısını gün bazında gösterir.
Etkinlikler
Rapor ayrıca şunları içerir: olaylar bilgi, araştırmacının bağlantı kurarken tamamladığı eylemler ORCID raporlama ayında sisteminizle kaydedin. Her olay, kullanıcının verdiği herhangi bir erişimi veya kullanıcı üzerinde yaptığı eylemi temsil eder. ORCID site (oturum açma veya sınırlı okuma erişimi verme gibi). Çoğu araştırmacının kendisiyle ilişkili birden fazla olayı olacaktır.
Bir olayın sonuna ‚√∫√π eklenmişse, bu, araştırmacının uzun ömürlü (Pkalıcı) belirteç, bir saat içinde sona eren kısa ömürlü bir belirteç ile karşılaştırıldığında. Mart 2018'den bu yana, platformda yalnızca uzun ömürlü belirteçler desteklenmektedir. ORCID Kayıt; entegre sisteminiz veya kullanıcı, belirteci istediği zaman iptal etmeyi seçebilir.
Ülkeye göre kullanıcılar
Raporların son bölümü, entegrasyonunuzu kullanan araştırmacılar hakkında, entegrasyonunuza eriştikleri ülkeye göre ayrılmış bilgiler içerir. Bu veriler, bir araştırmacının IP adresinden veya Coğrafi Kimliğinden (kendisi Google tarafından araştırmacının IP adresinden belirlenir) elde edilir.
Örnekleme
Çünkü pek çok araştırmacının kullandığı ORCID Kayıt defteri, araştırmacı verilerinin tamamı hakkında rapor çalıştırmak mümkün değildir. Bunun yerine burada sağlanan sayılar, örneklenmiş ve örneklenmemiş bir kümedeki eğilimler kullanılarak üretilmiştir. Raporun örneklenen verilerden türetilen bölümleri bir yıldız işaretiyle işaretlenir ve örneklenen boyut ve alan, Analytics verileri sekmesinde belirtilir. Raporun Google Analytics bölümündeki rakamlar, tuttuğunuz hiçbir yerel istatistikle tam olarak eşleşmeyebilir ve raporun bölümleri arasında küçük tutarsızlıklar olabilir.
Entegrasyon Analitiği altında listelenen örnekleme parametreleri, yıldız işaretiyle işaretlenmiş tüm bölümler için geçerlidir. Analiz verileri tarafından yakalanan oturumların yüzdesi (örnek boyutu)/(örnek alanı) * %100'dür. Örnekleme hakkında daha fazla bilgi şu adreste bulunabilir: Google Geliştiriciler.
Boş raporlar
Raporun Kullanıcılar ve Etkinlikler bölümleri yalnızca geçen aya ait verileri içerir. Geçen ay hiçbir araştırmacı entegrasyonunuzu kullanmadıysa hiçbir veri döndürülmez.
Sorular
Üye raporlarınız hakkında herhangi bir sorunuz varsa, lütfen İletişim.
The ORCID Kayıt defteri, kullanıcıların kimliklerini OAuth kullanan kuruluşlara sağlaması için tasarlanmıştır; iD her araştırmacı için toplanır. Kuruluşları eklemekten caydırıyoruz ORCID Adlarına göre araştırmacılar için bir aramaya dayalı olarak sistemlerine kimlikler. Ancak, kuruluşunuzdaki kaç araştırmacının çalıştığını öğrenmek yararlı olabilir. ORCID API aracılığıyla yapılabilecek iD'ler. Kuruluşa göre arama önerileri aşağıda verilmiştir.
Aramaya giriş, erişim belirtecinin nasıl alınacağı, arama sonuçlarınızın nasıl anlaşılacağı ve aranabilecek diğer alanların ayrıntıları için lütfen şu bölümümüze bakın: Kayıt defterinde arama API Eğitimi
Ada ve DOI'ye göre ara
Bir kişinin sahip olup olmadığını kontrol ederken ORCID kayıt, hem isimlerine hem de son çalışmalarından bir veya daha fazlasının DOI'sine göre arama yapmanızı öneririz. Bu, yalnızca aradığınız araştırmacının kaydıyla sonuçlanmalı ve aynı adı paylaşan başka birinin kayıtları olmamalıdır.
"Laurel Haak" ve DOI 10.1087/20120404 veya DOI 10.6084/M9.FIGSHARE.1115124 adlı tüm kayıtları aramak için örnek bir çağrı:
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
Üyeliğe göre ara
Bağlantı alanları, bağlantının adı veya kuruluşun benzersiz ROR Kimliği veya GRID Kimliği kullanılarak aranabilir. (Kuruluşunuzun GRID Kimliğini şu adreste bulabilirsiniz: GRID veya ROR kimliğiniz ROR kaydı)
Kuruluş adına göre ara
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"
Veya tam bir eşleşme için
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)
GRID kimliğine göre ara
GRID ID grid.5509.9'a sahip tüm kayıtları aramak için bir örnek çağrı (Tampere Üniversitesi):
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
ROR kimliğine göre ara
ROR kimliğine sahip tüm kayıtları aramak için örnek bir çağrı 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"
E-posta etki alanına göre ara
Araştırmacıları e-posta etki alanına göre aramak için API'yi kullanabilirsiniz. E-posta adreslerinin yaklaşık %97'sinin ORCID özeldir ve özel veya güvenilir erişim e-posta adresine sahip kayıtlar bu aramada döndürülmez.
@orcid.org e-posta adresine sahip tüm kayıtları aramak için bir örnek çağrı:
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
CSV biçiminde döndürülen arama sonuçları
Arama sonuçları CSV biçiminde de döndürülebilir. Çağrının bir parçası olarak, aşağıdaki kullanılabilir alanlar listesinden çıktı sütunlarını belirleyebilirsiniz:
orcid
E-posta
isim
soyadı
verilen-ve-aile-isimleri
kredi adı
diğer isim
mevcut kurum-bağlılık-adı
geçmiş-kurum-bağlılık-adı
Kimlik bilgilerinizi kullanarak başlığı 'olarak belirtmeniz gerekir.metin/csv'. Arama çağrısının bir parçası olarak, çıktıda ihtiyaç duyduğunuz alanları da sorguya eklemeniz gerekir.
Yalnızca tarayıcınızı kullanarak arama
Aramayı tarayıcınızı kullanarak da tamamlayabilirsiniz. URL aynı şekilde oluşturulur ancak herhangi bir API kimlik bilgisi kullanmanız gerekmez. Lütfen bunun yalnızca genel API kullanılarak tamamlanabileceğini unutmayın.
Aşağıda, kuruluş adına göre arama yapan genel API'yi kullanan örnek bir çağrı bulunmaktadır. ORCID, istenen çıktı olarak verilen adlar, aile adları, mevcut kurum üyelik adı ve geçmiş kurum üyelik adı.
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
Aşağıda, kuruluş adının farklı varyasyonlarına göre arama yapan genel API'yi kullanan başka bir örnek çağrı bulunmaktadır.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:("University of Plymouth" OR "Plymouth University")
eduPerson şeması şunu ekledi: eduKişiOrcid öznitelik onun Şubat 2016 güncellemesi.
Göre eduPerson belirtimi:
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' )
Bu alanın biçiminin şu olduğunu unutmayın: ORCID- iD'nin tercih edilen URI gösterimiÖrneğin, https://orcid.org/0000-0001-5727-2427.
formatı hakkında daha fazla bilgi ORCID iD bulunabilir Yapısı ORCID tanımlayıcı.
ORCID üzerine kuruldu prensip araştırmacıların kendi bilgileri üzerinde kontrol sahibi olması gerektiği. Bu prensibi onurlandırmak için güçlü bir gizlilik politikasını kabul ettiğinizi onaylıyorsunuz.gizlilik düzenlemelerindeki yerel farklılıkları hesaba katmak için tasarlanmış ve politikalar ve işlevsellik geliştirirken araştırmacının bakış açısına odaklanıyoruz.
bizim ile uyumlu olarak temel ilke araştırmacı kontrolü, ORCID kayıtlar yalnızca araştırmacıların kendileri tarafından oluşturulabilir. ORCID https://serdartavaslioglu.com sitesi üzerinden ücretsiz erişebilirseniz.
Entegrasyon iş akışınızın bir parçası olarak, araştırmacılarınız yeni bir ORCID iD veya kimliği doğrulanmış bilgilerini toplamanıza olanak tanıyan mevcut kayıtlarında oturum açın. ORCID İD. lütfen bizimkine bakın API eğitimleri daha fazla bilgi için.
Eğer kuruluşunuz bir ORCID üye o zaman iletişime geçmeniz gerekir ORCID erişiminizi sağlayabilecek kuruluşunuzla iletişim kurun. ORCID Üye Portalı. Kuruluşlarınızı tanımlayamıyorsanız ORCID iletişime geçin, ardından lütfen Konsorsiyum Lideriniz veya Sözleşme Ekibi temsilcinizle iletişime geçin.
Topluluğumuzdan gelen geri bildirimleri seviyoruz, bu nedenle üye raporları hakkında herhangi bir geri bildiriminiz varsa lütfen bizimle iletişime geçerek bize bildirin. https://support.orcid.org/hc/en-us/requests/new
Üye ve entegrasyon raporlarını oluşturmak için kullanılan veriler günlük olarak güncellenir.