DATUEN API
Open Data Bizkaiaren orrialde honen barruan aplikazioen garatzaileentzat eta profil teknikoagoa duten erabiltzaileentzat erabilgarria den informazioa eskaintzen da. Hurrengo ataletan, oinarrizko alderdiak eta datasetak eta errekurtsoak CKANen API bidez eskuratzeko metodoak zehazten dira.
- Zer da API bat
- Zein da errekurtso baten identifikatzailea
- Nola lortu errekurtso baten eremuen izenak
- Nola erabiltzen den API kontsultak egiteko
- Nola lortu errekurtso baten datu eguneratuak
Informazio gehiago -ean API-ren Datu nagusien eta CKAN-en DataStore-aren dokumentazioa (ingelesez).
-
API sarbide-puntua
Datuen API-a CKAN-en API ekintzaren hurrengo ekintzen bitartez irisgarria da.
Sortu
https://www.opendatabizkaia.eus/es/api/3/action/datastore_create
Eguneratu / Txertatu
https://www.opendatabizkaia.eus/es/api/3/action/datastore_upsert
Kontsulta
https://www.opendatabizkaia.eus/es/api/3/action/datastore_search
Kontsulta (SQL-ren bidez)
https://www.opendatabizkaia.eus/es/api/3/action/datastore_search_sql
-
Kontsulta adibidea
Kontsulta-adibidea (lehen bost emaitzak)
https://www.opendatabizkaia.eus/es/api/3/action/datastore_search?id=58f8c26e-996a-42e3-a49e-ef1e8e754ce6&limit=5
Kontsulta adibidea ("HIGIEZIN MOTA_CAS/TIPO INMUEBLE_CAS" eremuan "TERRENO" balioa duten emaitzak)
https://www.opendatabizkaia.eus/es/api/3/action/datastore_search?id=58f8c26e-996a-42e3-a49e-ef1e8e754ce6&q={%22HIGIEZIN%20MOTA_CAS/TIPO%20INMUEBLE_CAS%22:%22%TERRENO%%22}
Kontsulta adibidea (SQL sententziaren bidez)
https://www.opendatabizkaia.eus/es/api/3/action/datastore_search_sql?sql=SELECT%20*%20from%20%2258f8c26e-996a-42e3-a49e-ef1e8e754ce6%22%20WHERE%20%22KALEA/CALLE%22%20LIKE%20%27EL%VIVERO%%27
-
Adibidea: JavaScript
(JSONP) ajax kontsulta erraz bat API datuei jQuery erabiliz.
var data = { resource_id: ‘58f8c26e-996a-42e3-a49e-ef1e8e754ce6', // the resource id limit: 5, // get 5 results }; $.ajax({ url: '/datastore_search', data: data, dataType: 'jsonp', success: function(data) { alert('Total results found: ' + data.result.total) } });
-
Adibidez: Python
import urllib.request url = 'https://www.opendatabizkaia.eus/es/api/3/action/datastore_search?id=58f8c26e-996a-42e3-a49e-ef1e8e754ce6&limit=5' fileobj = urllib.request.urlopen(url) print(fileobj.read())