Tasca #7672
tancatCanvis a l'API de Web of Science
Descripció
Hem rebut aquesta informació. Haurem d'adaptar la manera com consultem la seva API per les citacions:
De: Recursos Cientificos <recursoscientificos@fecyt.es>
Enviat: dimarts, 24 de gener de 2023 10:40
Per a: Recursos Cientificos <recursoscientificos@fecyt.es>
Tema: Cambios en APIs de Web of Science 2023
Estimados/as colegas,
Me pongo en contacto con vosotros para informaros de los cambios que se van a producir a lo largo de 2023 en el sistema de gestión y acceso de las APIs de Web of Science y que implica una actualización de vuestros sistemas para continuar haciendo uso de ellas.
Hasta ahora, las APIs AMR y Lite utilizaban una tecnología SOAP y para configurarlas, era necesario conocer un usuario y una contraseña que proporcionamos desde la FECYT.
Sin embargo la API Expanded, incluida en la última renovación de la licencia, funciona con tecnología REST y para su explotación, es necesario un registro previo el en portal de desarrolladores de la Web of Science (https://developer.clarivate.com/).
A partir de noviembre de 2023, Clarviate nos ha comunicado que las APIS que utilizan tecnología SOAP van a desaparecer (API AMR y API Lite) y se van a convertir en la Starter API, que funcionará con tecnología REST, al igual que la API Expanded, por lo que será necesario el registro en el portal de desarrolladores de la Web of Science (https://developer.clarivate.com/).
Por este motivo, rogamos que tengan en cuenta esta casuística ya que requerirá de unos cambios y adaptaciones en sus programas de cliente de servicio web para que admitan la tecnología REST, y poder continuar utilizando las APIs de WoS como hasta ahora.
Lamentamos los inconvenientes que esta situación les provoca y les enviamos un cordial saludo,
Abdón
Recursos Científicos de FECYT
https://www.recursoscientificos.fecyt.es/
Fundación Española para la Ciencia y la Tecnología
C/ Pintor Murillo, 15 (Edificio Museo Nacional de Ciencia y Tecnología) - 28100 Alcobendas
Tfno: 91 425 09 09 - Fax: 91 571 21 72
FJ Actualitzat per Ferran Jorba fa aproximadament 3 anys
En principi només hauria de tocar la funció get_wos_citations_count(doi) de ~/bin/check024doi.py.
FJ Actualitzat per Ferran Jorba fa aproximadament 3 anys
- Data de venciment s'ha establert a 01-10-2023
FJ Actualitzat per Ferran Jorba fa quasi 3 anys
- Estat ha canviat de Creada a En curs
M'estic mirant les diferents apis que oferexien Clarivate (https://developer.clarivate.com/apis) i he après algunes coses:
- Que cal registrar-se i esperar l'aprovació, que "may take a few days". Suposo que val la pena utilitzar el compte institucional ddd.bib@uab.cat.
- Que hem de triar quina API ens convé.
- M'ha semblat que per algunes coses ho tenim pagat i per altres potser no, però no ho tinc clar del tot.
Nosaltres hem estat utilitzant (i encara utilitzem) l'API antiga per una cosa, que acaben essent dues: a partir del DOI del document, via la seva API aconseguim dues informacions: quin és el seu identificador (que posem a la nostra 035) i quin és el número de citacions, que va a parar a la base de dades de comptador de citacions, i que apareix a la part superior dreta dels registres amb DOI.
El funcionament està explicat a #4950. El que fem és que cada mitja hora un programa es connecta a les diferents bases de dades remote (ara mateix Scopus i WoS) per fer una cerca via DOI i obtenir el seu identificador i el número de citacions. Això es guarda als 035 i a la base de dades de citacions, junt amb la data de la consulta. Així, anem fent consultes periòdiques, fent rotació per tots els nostres registres amb DOI.
Diria que amb les noves API, n'hi ha dues que oferexen el "citation count":
- https://developer.clarivate.com/apis/wos-starter Starter API. Amb el (free?) "Institutional plan" podem fer fins a 1000 peticions diàries.
- https://developer.clarivate.com/apis/wos Web of Science API Expanded. Requereix pagament, i va per peticions per segon i màxims anuals.
Ara mateix al DDD hi tenim 38.496 documents públics amb DOI. Si la Starter API ens funcionés, podríem en unes 5 setmanes, actualizar tots els comptadors. Dit d'una altra manera, cada document tindria el comptador de citacions actualitzat cada 5 setmanes. Clar que això anirà a més, perquè el número de registres amb DOI va creixent contínuament.
No sé quin acord hi ha amb la FECYT i si ens paguen alguna cosa o va a càrrec de la UAB. Jo potser començaria per aquí.
FJ Actualitzat per Ferran Jorba fa quasi 3 anys
Segons la llicència 2021-23 (https://lacarpeta.uab.cat/documents/1734797/1971627/Web+of+Science+bbdd+2021_2023/60dc5036-3593-4891-bbd6-a197d44bbba6?version=1.0&download=true), tenim:
Adicionalmente, incluido en el contrato de acceso a las bases de datos de WOS se incluye el cceso a tres APIs de Web of Science: la API de Web of Science - Expandida (Web of Science API-Expanded), API de Web of Science – Lite (Web of Science API-Lite), API de Web of Science - Recuperación de artículos (Web of Science API-Article Match Retrieval).
[...]
4. CONDICIONES PARTICULARES APLICABLES A LAS APIs DE WEB OF SCIENCE.
APLICABILIDAD. Los siguientes términos se aplican a su uso de la API de Web of Science - Expandida (Web of Science API-Expanded), API de Web of Science – Lite (Web of Science API-Lite), API de Web of Science - Recuperación de artículos (Web of Science API-Article Match Retrieval).
ACCESO. En el caso del protocolo SOAP, Clarivate Analytics proporciona un acceso por Entidad Autorizada, a petición de la FECYT – A lo largo de la ejecución del contrato, Clarivate puede dejar de mantener el protocolo SOAP para solo proveer REST. En este caso, cada Entidad Autorizada tendrá que pedir su Token a través del Portal de desarrolladores de Clarivate Analytics disponible en https://developer.clarivate.com/. Los datos disponibles a través de la API están limitados a los datos disponibles a través de su licencia de suscripción y solo pueden acceder a ellos los mismos usuarios que tienen acceso permitido por su suscripción. La API se cerrará tras identificar cualquier otro uso que la alimentación de un CRIS o repositorio local. Si su licencia de suscripción para los datos proporcionados a través de la API finaliza o caduca, sus derechos respecto a la API cesarán de forma simultánea y deberán eliminarse los datos que hubiera descargado a menos que otorguemos una autorización por escrito o acordemos mutuamente por escrito lo contrario.
FJ Actualitzat per Ferran Jorba fa més de 2 anys
Tenim ja registra l'aplicació ddd-uab-cat a partir de l'username rosa.gil@uab.cat i la seva contrasenya a WoS.
FJ Actualitzat per Ferran Jorba fa més de 2 anys
Al final m'he vist incapaç de sortir-me'n per mi sol i he demanat assistència a una adreça que m'he trobat a una presentació del Fecyt que Google m'ha trobat mentre buscava exemples: https://www.recursoscientificos.fecyt.es/sites/default/files/clarivate_training_sesiond1_for_fecyt_oct_2022.pdf.
Assumpte: Api search by doi and return wos_id and citation_count
Data: Thu, 5 Oct 2023 09:55:11 +0200
De: Ferran Jorba <Ferran.Jorba@uab.cat>
Organització: Universitat Autònoma de Barcelona
A: WoSG.support@clarivate.com
Dear sirs,
I'm trying to convert a program that we have been using during the last few years that, using the (old) soap api, uses a doi to return the document wos_id and the citation count.
Our university has access both to the Starter API and the Expanded API, and we have the api keys for both and we have registered our aplication (ddd-uab-cat).
I have digged into the apis documentation (https://developer.clarivate.com/apis/wos), I have read the examples found in Github (https://github.com/clarivate), but I have been unable to find examples about how to accomplish that, even with a two api calls. We prefer Python examples, or url samples.
Your help is much appreciated.
Ferran Jorba
He rebut una resposta automàtica que ens assignen el cas CM-231005-6704541 i que es posaran en contacte amb mi en les properes 24 hores.
FJ Actualitzat per Ferran Jorba fa més de 2 anys
- Estat ha canviat de En curs a Tancada
La veritat és que m'han contestat amb un parell d'exemples molt clars, però que, després, he mirat de trobar a la documentació de la seva web i no hagués sabut construir-los jo sol.
Sigui com sigui, he vist que amb la Starter Api en tenim prou, perquè bàsicament el que fa és retornar informació d'identificadors (wos_id, pmid, etc, i nombre de citacions). He vist que l'Expanded Api també ens funcionaria, perquè retorna aquests valors, però amb moltíssima més informació bibliogràfica que tampoc aprofitaríem.
Per tant, faig una crida amb una url del tipus https://api.clarivate.com/apis/wos-starter/v1/documents?db=WOS&q=DO=%s&limit=1&page=1, passant el nostre valor de l'Api Key (i sí, és necessari passar-li el limit= i la page=; ho he provat sense i diu que falten aquests paràmetres). Només substituint la funció que cridava l'antiga api per la nova, el programa efectivament funciona igual.
Els hi he donat les gràcies i tanco la tasca.