Obtenció de dades com a servei
Hem habilitat un sistema de web service que permet obtenir informació de la base de dades en format JSON que pot ser utilitzada en altres llocs web o en bots.
La llista següent indica les comandes disponibles, el format de la petició i alguns comentaris. Més endavant es detalla el format en el que surten les dades.
Consultar el llistat d'àmbits
Ens torna la llista de tots els àmbits que s'han fet servir per classificar les dones i el codi que correspon a cada un.
Format de la petició: https://recursos.citcea.upc.edu/dones/service.php?tipus=llista
Exemple: https://recursos.citcea.upc.edu/dones/service.php?tipus=llista
Format de sortida: Llista d'àmbits
Consultar la llista de dones que pertanyen a un àmbit
Ens torna les dades bàsiques de les dones que pertanyen a l'àmbit indicat.
Format de la petició: https://recursos.citcea.upc.edu/dones/service.php?tipus=ambit&ambit=XX
on XX és el codi d'àmbit obtingut a partir d'una consulta anterior.
Exemple: https://recursos.citcea.upc.edu/dones/service.php?tipus=ambit&ambit=EC
Format de sortida: Llista de dones
Consultar la llista de dones catalanes
Ens torna les dades bàsiques de les dones que s'han marcat com a catalanes.
Format de la petició: https://recursos.citcea.upc.edu/dones/service.php?tipus=cat
Exemple: https://recursos.citcea.upc.edu/dones/service.php?tipus=cat
Format de sortida: Llista de dones
Consultar la llista de dones joves
Ens torna les dades bàsiques de les dones que han nascut les darreres dècades.
Format de la petició: https://recursos.citcea.upc.edu/dones/service.php?tipus=joves
Exemple: https://recursos.citcea.upc.edu/dones/service.php?tipus=joves
Format de sortida: Llista de dones
Consultar la informació d'una dona concreta
Ens torna les dades completes de la dona que correspon a l'identificador indicat.
Format de la petició: https://recursos.citcea.upc.edu/dones/service.php?tipus=concreta&id=nn
on nn és el número d'identificador obtingut a partir d'una consulta anterior.
Exemple: https://recursos.citcea.upc.edu/dones/service.php?tipus=concreta&id=411
Format de sortida: Dades d'una dona
Consultar la informació de la dona del dia
Ens torna les dades completes de la dona del dia, una dona escollida a partir de la data d'avui.
Format de la petició: https://recursos.citcea.upc.edu/dones/service.php?tipus=dia
Exemple: https://recursos.citcea.upc.edu/dones/service.php?tipus=dia
Format de sortida: Dades d'una dona
Consultar la informació d'una dona escollida aleatòriament
Ens torna les dades completes d'una dona escollida aleatòriament entre totes les de la base de dades.
Format de la petició: https://recursos.citcea.upc.edu/dones/service.php?tipus=aleat
Exemple: https://recursos.citcea.upc.edu/dones/service.php?tipus=aleat
Format de sortida: Dades d'una dona
Imatge de la dona del dia
A més, podem obtenir una imatge de la dona del dia amb les dades bàsiques. Aquesta imatge té sempre la mateixa adreça URL per tal de poder-la incorporar en una pàgina web i que cada dia s'actualitzi. L'adreça de la imatge és:
https://recursos.citcea.upc.edu/dones/donadia.php
Com a exemple, a continuació tenim la dona d'avui:
Format de la llista d'àmbits
A continuació es mostra l'estructura d'aquest format. Els caràcters especials estan codificats en HTML.
{
"info": {
"tipus": "Camps",
"descrip": "Camps en els que s'han classificat les dones",
"creat": "20211118",
"autoria": {
"autor": "Oriol Boix",
"contacte": "oriol.boix@upc.edu"
}
},
"dades": [
{
"Codi": "PA",
"Nom": "Antropologia, paleontologia i arqueologia"
},
.
.
.
{
"Codi": "TP",
"Nom": "Tèxtil i paperera"
}
]
}
Format de la llista de dones
A continuació es mostra l'estructura d'aquest format. Els caràcters especials estan codificats en HTML.
{
"info": {
"tipus": "Llista d'ambit",
"descrip": "Llista de les dones que pertanyen a l'ambit demanat",
"creat": "20211118",
"autoria": {
"autor": "Oriol Boix",
"contacte": "oriol.boix@upc.edu"
}
},
"dades": [
{
"Id": "1103",
"Ambit": "EC",
"Nom": "Deirdre Nansen McCloskey",
"Nom casada": "",
"Altre nom": "",
"Professio": "Economista estatunidenca",
"Fet destacat 1": "Ha analitzat el mal ús de la significació estadística en economia i altres ciències"
},
.
.
.
{
"Id": "874",
"Ambit": "EC",
"Nom": "Teresa Garcia-Milà i Lloveras",
"Nom casada": "",
"Altre nom": "",
"Professio": "Economista catalana",
"Fet destacat 1": "Estudia el paper de la inversió pública en el creixement econòmic"
}
]
}
Format de les dades d'una dona
A continuació es mostra l'estructura d'aquest format. Els caràcters especials estan codificats en HTML.
{
"info": {
"tipus": "Dona concreta",
"descrip": "Dades de la dona demanada a la peticio",
"creat": "20211121",
"autoria": {
"autor": "Oriol Boix",
"contacte": "oriol.boix@upc.edu"
}
},
"dades": [
{
"Id": "411",
"Ambit": "EM",
"Nom": "Allie Weber",
"Data neix": "20050504",
"Data mort": "",
"Nom casada": "",
"Altre nom": "",
"Professio": "Inventora estatunidenca",
"Fet destacat 1": "Ha patentat uns guants per prevenir glaçades (va sol·licitar la patent als onze anys)",
"Fet destacat 2": "Finalista del 3M Young Scientist Lab. de 2017",
"Fet destacat 3": "Reconeguda a la llista Teen Vogue 21 Under 21 de 2017",
"Foto": "d411.jpg",
"Font de la foto": "http://www.thesteamsquad.org/AllieWeber.html"
}
]
}
Per obtenir l'adreça URL completa de la foto cal posar-li el següent al davant:
https://recursos.citcea.upc.edu/dones/fotos/
Per exemple:
https://recursos.citcea.upc.edu/dones/fotos/d411.jpg
Format del contingut
El contingut es mostra emprant text en HTML, això vol dir que els caràcters especials s'han substituït pels codis HTML corresponents. Per exemple la lletra a amb accent greu es representa amb à i el punt volat amb ·.
Format de les dates
Les dates estan en un format compacte que, a més, permet ordenar-les. Cal tenir present, però, que en molts casos les dates són incompletes i, per tant, el format ha de ser capaç de guardar-ho.
Una data completa es representa amb vuit digits; els quatre primers són l'any, els següents el més i els darrers el dia. Per exemple 20210619 correspon al 19 de juny de 2021. Si no se sap el dia o el mes, el seu valor és zero. Per exemple 20210600 indica juny de 2021 i 20210000 representa l'any 2021.
Si només se'n sap el segle, el dia i el mes estan a zero i les dues darreres xifres de l'any es substitueixen per asteriscs; per exemple 20**0000 correspon al segle XXI.
Si la data és anterior a la nostra era (aC) s'indica afegint una a al final, per exemple 03**0000a fa referència al segle IV aC. Típicament les dates anteriors a la nostra era només tenen el segle, però no es descarta que alguna tingui més informació.
Aquesta obra d'Oriol Boix està llicenciada sota una llicència no importada Reconeixement-NoComercial-SenseObraDerivada 3.0.