0
API
RECOLECTA
DE ENRIQUECIMIENTO DEL METADATO
FUENTE DE
FINANCIACIÓN
MANUAL
API
RECOLECTA
de enriquecimiento del metadato
fuente de financiación
MANUAL
Fecha
publicación: 29
abril 2021
API
RECOLECTA
DE ENRIQUECIMIENTO DEL METADATO
FUENTE DE
FINANCIACIÓN
MANUAL
1
La Fundación Española para la Ciencia y la Tecnología (FECYT) ha desarrollado una API ( application
programming interface) para enriquecer el metadato en el que se almacena la información relacionada
con la fuente de financiación de los trabajos alojados en los repositorios que forman parte de
RECOLECTA.
Esta API REST da acceso público a la información de los proyectos de I+D publicados en el buscador de
RECOLECTA sin necesidad de autenticación, y permite a los repositorios su consulta para asociarlos con
sus publicaciones. A continuación se presentan los campos a través de los cuales se pueden hacer
búsquedas desde la API, se indican sus atributos y se especifica la información que se obtendrá en las
llamadas a la base de datos.
CAMPO ATRIBUTOS ¿QUÉ INFORMACIÓN DEVUELVE LA API?
codigo
Cadena de caracteres con
formato. Contiene el año de
convocatoria
El proyecto cuyo código asignado por la agencia de
financiación correspondiente contenga la secuencia
dada
titulo Cadena de caracteres Los proyectos cuyo título contenga la(s) palabra(s)
dada(s)
convocatoria Año con el formato YYYY Los proyectos con el año de convocatoria dado
programa Cadena de caracteres Los proyectos cuyo programa contenga las palabras
dadas
subprograma Cadena de caracteres Los proyectos cuyo subprograma contenga las
palabras dadas
nombre_agencia Acrónimo del nombre de la
agencia
Los proyectos financiados por la agencia cuyo
acrónimo se corresponda con el acrónimo dado
codigo_agencia URL con el código de la
agencia
Los proyectos cuyo identificador persistente de
agencia contenga las palabras dadas
centro_beneficiario Cadena de caracteres Los proyectos cuyo centro beneficiario contenga las
palabras dadas
centro_ejecucion Cadena de caracteres Los proyectos cuyo centro de realización contenga las
palabras dadas
duracion Número de meses Los proyectos con la duración dada
nombre_actuacion Cadena de caracteres Los proyectos cuyo nombre de actuación contenga las
palabras dadas
API
RECOLECTA
DE ENRIQUECIMIENTO DEL METADATO
FUENTE DE
FINANCIACIÓN
MANUAL
2
unidad_gestion Cadena de caracteres Los proyectos cuya unidad de gestión contenga las
palabras dadas
entidad_convocante Cadena de caracteres Los proyectos cuya entidad convocante contenga las
palabras dadas
Características técnicas:
• La URL de acceso es https://buscador.recolecta.fecyt.es/api/rest/proyectos.
• La API1 ofrece la posibilidad de devolver la respuesta para el perfil de aplicación OAI_DC2
(info:eu-
repo/grantAgreement/Funder/FundingProgram/ProjectID/[Jurisdiction]/[ProjectName]/[Project
Acronym]) o para el de OAI_OAIRE3
(oaire:fundingReferencesoaire:fundingReferenceoaire:funderNameFunderName</dataci
te:funderName><oaire:funderIdentifier funderIdentifierType="Crossref Funder
ID">FunderIdentifier</oaire:funderIdentifier>oaire:fundingStreamFundingProgram</oaire:fu
ndingStream>oaire:awardNumberProjectID</oaire:awardNumber>oaire:awardTitleProject
Name</oaire:awardTitle></oaire:fundingReference></oaire:fundingReferences>).
● Sólo se admitirán peticiones GET.
● La API permite realizar consultas a través de cualquiera de los campos señalados, añadiéndolo
como parámetro a la petición GET. Ejemplo:
https://buscador.recolecta.fecyt.es/api/rest/proyectos?codigo=ITC-
201611622&nombre_agencia=MINECO
● La respuesta JSON a la petición GET tiene el siguiente formato:
o Para el perfil de aplicación OAI_DC:
[{"titulo":"CARACTERIZACI\u00d3N DE LAS FRACCIONES FUNCIONALES DE LA ACEITUNA,
FORMULACI\u00d3N DE NUEVOS PRODUCTOS Y AN\u00c1LISIS DE SUS
EFECTOS","nombre_actuacion":"Convocatoria FEDER INNTERCONECTA
2016","codigo_agencia":"http://dx.doi.org/10.13039/501100010198","nombre_agencia"
:"MINECO","centro_beneficiario":"NEURON BIOPHARMA, SA (HASTA 2014)","codigo":"ITC-
20161265-1","duracion":28,"centro_ejecucion":"NEURON BIOPHARMA,
SA","unidad_gestion":"Centro para el Desarrollo Tecnol\u00f3gico Industrial
(CDTI)","entidad_convocante":"Ministerio de Econom\u00eda y
Competitividad","programa":"Programa Estatal de I+D+I Orientada a los Retos de la
Sociedad","subprograma":"Todos los
1 Ver anexos 5 y 6 de la Guía para la evaluación de repositorios institucionales de investigación.
2 Para el perfil de aplicación oai_dc este campo se recoge en el metadato dc:relation y se adopta el estándar de codificación de las Guidelines for Literature
Repositories v3
3 Para el perfil de aplicación oai_oaire se adopta el elemento fundingReference y sus subpropiedades de DataCite MetadataKernel v4, de acuerdo con las
OpenAIRE Interoperability Guidelines for Literature Repository Managers 4.0.1.
API
RECOLECTA
DE ENRIQUECIMIENTO DEL METADATO
FUENTE DE
FINANCIACIÓN
MANUAL
3
retos","convocatoria":2016,"proyecto":"info:eurepo/grantAgreement/MINECO/Plan
Estatal de Investigación Científica y Técnica y de Innovación 2013-2016/ITC-20161265-
1/ES/CARACTERIZACIÓN DE LAS FRACCIONES
FUNCIONALES DE LA ACEITUNA, FORMULACIÓN DE NUEVOS PRODUCTOS Y ANÁLISIS DE SUS
EFECTO"}]
o Para el perfil de aplicación OAI_OAIRE:
[{"titulo":"CARACTERIZACI\u00d3N DE LAS FRACCIONES FUNCIONALES DE LA ACEITUNA,
FORMULACI\u00d3N DE NUEVOS PRODUCTOS Y AN\u00c1LISIS DE SUS
EFECTOS","nombre_actuacion":"Convocatoria FEDER INNTERCONECTA
2016","codigo_agencia":"http://dx.doi.org/10.13039/501100010198","nombre_agencia"
:"MINECO","centro_beneficiario":"NEURON BIOPHARMA, SA (HASTA 2014)","codigo":"ITC-
20161265-1","duracion":28,"centro_ejecucion":"NEURON BIOPHARMA,
SA","unidad_gestion":"Centro para el Desarrollo Tecnol\u00f3gico Industrial
(CDTI)","entidad_convocante":"Ministerio de Econom\u00eda y
Competitividad","programa":"Programa Estatal de I+D+I Orientada a los Retos de la
Sociedad","subprograma":"Todos los
retos","convocatoria":2016,"proyecto":"oaire:fundingReferencesoaire:fundingReference
oaire:funderNameMinisterio de Economía y
Competitividad</datacite:funderName><oaire:funderIdentifier
funderIdentifierType="Crossref Funder ID">
http://dx.doi.org/10.13039/501100003329</oaire:funderIdentifier><oaire:fundingStrea
m> Plan Estatal de Investigación Científica y Técnica y de Innovación
20132016</oaire:fundingStream>oaire:awardNumber ITC-20161265-
1</oaire:awardNumber>oaire:awardTitleCARACTERIZACIÓN DE LAS FRACCIONES
FUNCIONALES DE LA ACEITUNA, FORMULACIÓN DE NUEVOS PRODUCTOS Y ANÁLISIS DE SUS
EFECTOS</oaire:awardTitle></oaire:fundingReference></oaire:fundingReferences>"}]
● La petición GET de consulta devuelve los resultados en páginas de 50 elementos, por defecto,
pudiendo variar el número de elementos por página incluyendo el parámetro “pagesize”. Por
ejemplo, para fijar el tamaño de página con 10 elementos, la petición URL quedaría como
https://buscador.recolecta.fecyt.es/api/rest/proyectos?pagesize=10.
● El parámetro GET “page” permite obtener los elementos de cualquier otra página de resultados.
Por ejemplo, si se desea consultar la página 2 de todos los proyectos de la API, la petición URL
quedaría como https://buscador.recolecta.fecyt.es/api/rest/proyectos?page=2
● En el caso que sea necesario buscar por más de un término para un campo, como puede ser
título, sería necesario repetir el filtro por dicho campo por cada uno de los términos a buscar:
https://buscador.recolecta.fecyt.es/api/rest/proyectos?titulo=TERMINO1&titulo=TERMINO2 ●
El parámetro para indicar la versión de las guidelines es “glv”.
o Para el perfil de aplicación OAI_DC, la URL de la petición quedaría como
https://buscador.recolecta.fecyt.es/api/rest/proyectos?glv=3
API
RECOLECTA
DE ENRIQUECIMIENTO DEL METADATO
FUENTE DE
FINANCIACIÓN
MANUAL
4
o Para el perfil de aplicación OAI_OAIRE, la URL de la petición sería:
https://buscador.recolecta.fecyt.es/api/rest/proyectos?glv=4
o Si no se especifica el parámetro, devolverá la versión de OAI_DC por defecto.
● Se puede buscar y visualizar la información de los proyectos en la página del buscador de
RECOLECTA, en la pestaña de Proyectos: https://buscador.recolecta.fecyt.es/buscadorrecolecta-
proyecto
Con respecto al campo proyecto, para el perfil de aplicación OAI_DC hay que tener en cuenta las
siguientes consideraciones:
o Cuando no se tiene o no existe información sobre alguno de los campos opcionales, hay
que preservar la información utilizando las barras “/”, por ejemplo:
info:eurepo/grantAgreement/Funder/FundingProgram/ProjectID///
o En el caso de que haya una barra “/” en cualquiera de los campos, es necesario escaparla
sustituyéndola por %2F: info:eu-
repo/grantAgreement/MSC/Otro/04%2F1983/ES/ELABORACION DE CONSTRUCTOS
CORNEALES ORGANOTIPICOS MEDIANTE INGENIERIA TISULAR ESTUDIO DE VIABILIDAD//