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())