Bu röportajda Rob Peters, ORCIDTeknoloji Direktörü, tanıtıyor ORCID'nin yeni API'si – 14 Şubat 2017'de kullanıma sunuldu
Yeni API hakkında konuşmaya başlamadan önce bize biraz bahseder misiniz? ORCIDTeknik Ekibi ve Direktör olarak rolünüz?
İlk bakışta, ORCID takım diğer teknik takımlara çok benziyor. Beş geliştiricimiz, bir sunucu yöneticimiz, bir kalite güvence analistimiz ve tabii ki bir yöneticimiz (ben) var. Ancak ilginç olan nokta, farklı coğrafi, kültürel ve iş geçmişlerimizdir. Üçümüz ABD merkezli, üçümüz Kosta Rika'da ve ikimiz Birleşik Krallık'ta bulunuyoruz, bu nedenle coğrafi olarak çok fazla perspektif elde ediyoruz. Ek olarak, bazılarımız geleneksel yazılım danışmanlığından, bazılarımız yayıncılık endüstrisinden, "Silikon Vadisi" girişimleri ve kütüphane bilimlerinden geliyoruz.
Teknoloji Direktörü olarak kişisel rolüm, günlük yazılım geliştirmeyi yönetmektir. Bu, ekibimin birbirleriyle ve organizasyonun geri kalanıyla iletişim kurmasına ve ekibin hangi görevleri üstlendiğini (ve hangilerinin ertelendiğini) yönetmesine yardımcı oluyor. Ayrıca üst düzey stratejik kararlarda çok fazla girdiye sahip olma fırsatı elde ediyorum. ORCID yapar.
API sürüm 2.0'a geçiyoruz – neden biz – ORCIDYanı sıra, ORCID topluluk – bu yükseltmeye mi ihtiyacınız var?
İlk ORCID Ekim 2012'de kullanıma sunulan API, kaçınılmaz olarak, daha sonra yanlış olduğu kanıtlanan ve/veya rafine edilmesi gereken birçok varsayıma dayanıyordu. Araştırma topluluğuna daha iyi hizmet verebilmek için bu varsayımları sürekli olarak incelememiz gerekir. Geri bildirimleri kullanmak, sorular sormak ve lansmanımızdan önce mevcut olmayan kanıtlara bakmak, bize yeni içgörüler kazandırdı. ORCID API olmalı ve olmamalıdır. Bir sonraki soruya verdiğim yanıttan da göreceğiniz gibi, Sürüm 2.0, iki API arasında süreklilik sağlayacak kadar pragmatik olmakla birlikte, 1.0'ın üzerine inşa edildiği varsayımlardan büyük bir kopuşu temsil ediyor.
1.2 ve 2.0 arasındaki temel farklar nelerdir ve bunlar üyelere nasıl fayda sağlar?
2.0'ı geliştirirken, hem üyelerin 1.2 ile karşılaştığı engellere değinmek hem de topluluğun istediğini bildiğimiz yeni işlevler sunmak istedik.
Aşırı yazarlı yayınların yönetilmesindeki ölçeklenebilirlik ve üyeler için kafa karışıklığına neden olan örtük davranışlarla ilgili zorluklar gibi bilinen sorunların üstesinden gelmenin yanı sıra, akran değerlendirmesi tanımayı desteklemek için yeni işlevler, kullanıcılar için geliştirilmiş bildirimler ve yeteneği ekledik. hemen hemen her şeyi destekleyin kalıcı tanımlayıcı
Bu değişikliklerden bazılarına neden ihtiyaç duyulduğunu açıklamak için biraz teknik konuşacağım. Tek bir yeni satırı kodlamaya başlamadan önce, aşağıdaki "manifesto" ile iyileştirilmesini istediğimiz şeylerin bir listesini yaptık:
- Düşünmeyi bırak ORCID yekpare (büyük tek) bir belge olarak kaydedin. Birden çok kurum bir ORCID kayıt, kaydın tanınması anlamına gelir çok kiracılı. Ek olarak, araştırmacılar genellikle o kadar büyük miktarda araştırma yaparlar ki, bunların özetleri bile yekpare bir belgeye sığmaz.
- Basitleştirilmiş kapsamlar. 1.0 API'deki izin kapsamlarının ayrıntı düzeyi, dahil olan tüm taraflar için çok fazladır; bunları basitleştirmek hem geliştiriciler hem de kullanıcılar için hayatı kolaylaştıracaktır.
- açık RESTful davranış. Örtük davranışlar, son kullanıcıların kafasını karıştıran beklenmedik davranışlara yol açtıkları için uygulayıcılar için kötüdür. Yeni API'miz, RESTful davranışını kullanarak bu sorunları önler.
- En kısa makul URL'ler. İyi bir örnek, /works/1234 is better from / olacaktır.orcid-işler/1234.
- Listeye yapılan çağrılar yalnızca özetleri döndürür. Bir kaydı daha hızlı çağırmak için API 2.0 yalnızca listeler için özetler döndürür. Bir araştırmacı hakkındaki her bilgi için tek bir çağrı yapmak, onlarca, yüzlerce hatta binlerce yazarın olduğu aşırı yazarlı makalelerde işe yaramaz.
- Ortak öğeler için ortak adlar ve yapılar. 2.0, XML/JSON'daki ortak öğelerin aynı adlara sahip olduğundan emin olmamızı sağlar.
- Hata kodları. Hata, standart bir HTTP kodu tarafından tam olarak tanımlanmadığında artık hata kodlarını yanıt gövdesine dahil ediyoruz.
Ve kullanıcılar için faydaları nelerdir?
Günün sonunda, bir API kullanıcılar için sorunsuz olmalıdır. Beklenmeyen 1.0 davranışı, bir yandan kullanıcı deneyimini etkilerken diğer yandan da API'yi uygulayan geliştiricileri sinirlendiriyor. Pratik bir düzeyde, yeni API, sistemdeki her bölümü kolaylaştırmayı sağlar. ORCID her bölümdeki öğeler için görünürlük ayarları, kaynak ve oluşturma tarihinin uygulanmasını tutarlı bir şekilde sağlamak için kayıt yapın.
Bu, Genel API'yi de etkiler mi? Nasıl?
Evet. Üye API'si ve Genel API'deki değişiklikler her zaman aynı doğrultudadır. Üye desteğini takdir etmemize ve buna güvenmemize rağmen, "araştırma, burs ve inovasyona katılan herkesin benzersiz bir şekilde tanımlandığı ve disiplinler, sınırlar ve zaman arasındaki katkılarıyla bağlantılı olduğu bir dünya" vizyonumuz için de kararlıyız. Public API'yi bu hedefe ulaşmaya yardımcı olacak bir araç olarak görüyoruz.
Sizce yeni sürümün kullanıma sunulmasındaki ana zorluklar neler olacak ve hangi destek sunulacak? ORCID sağlamak mı?
En zor konu, işi yapmak için kaynakları bir kenara ayırmaktır. yükseltmek. Bazı kuruluşlar için birkaç gün gibi kısa bir sürede, bazıları için ise tam bir ay gerekebilir. Zaman çerçevesi ne olursa olsun, ilerlemenizi engelleyen küçük bir ayrıntı için bile uzanıp yardım istemekten korkmayın. Tam dokümantasyon şimdi üyelerde mevcut.orcid.org ve ORCID üye kuruluşlar da İletişim. Şuraya gönderiliyor: API Kullanıcıları Forumu yararlı olabilir, dünyanın dört bir yanından yorumları getirerek ORCID toplum. Ayrıca doğrudan erişilebilir olmaya inanan biriyim, bu yüzden hissedin bana doğrudan e-posta gönder.
Şu anda API 2.0'ı kimler kullanıyor ve ne tür geri bildirimler sağladılar?
Geri bildirim almak için sürüm adaylarını kullanıma sunmak için çok çaba harcadık. CrossRef, Datacite, CERN ve PTCRIS bunlardan sadece birkaçıdır. ORCID bir sürüm adayını uygulayan ve geri bildirim sağlayan üyeler. Ek olarak, erken benimseyenler, Amerikan Jeofizik Birliği, F2.0 ve Publons dahil olmak üzere birçok kuruluş 1000'ı kullanarak akran değerlendirmesi işlevini uygulamıştır. Geri bildirim, şemada kullanılan adlar, uç nokta adlandırma veya verimlilikle ilgili tartışmalar gibi olağan "teknik" önerileri içeriyordu. Bu tür ayrıntıların üyeler için büyük etkileri olabilir. Bununla birlikte, sürüm adayı uygulayıcıları, araştırmacının bakış açısıyla da geri bildirim sağlar ki bu bizim için çok değerlidir.
Ne kadar sürecek ORCID eski API'yi desteklemeye devam edilsin mi?
1.2 sonunda gün batımı 2017'yi hedefliyoruz. Gün batımı tarihi ne olursa olsun, kabul ederseniz ORCIDmisyonu ve araştırmacıların birbirleriyle etkileşimini önemsemek ORCID şimdi 2.0'a geçmek isteyeceksiniz.
Bu değişiklik hakkında bilmemiz gereken başka bir şey var mı?
2.0'ın kalıcı olacağını umuyoruz ve oyunun diğer bölümlerine odaklanabiliriz. ORCID iyi bir süre için teknoloji yığını!
API 2.0 özelliklerinin eğlenceli ve kullanışlı bir özeti için buna bakın kaygan güverte!