Stranice za pomoć

Kontaktirajte nas

Ako niste pronašli odgovor na vaše pitanje ili nas želite kontaktirati vezano uz portal, pišite nam.

Aplikacijsko programsko sučelje - API

Uvod

Ova stranica objašnjava kako programeri mogu napraviti interakciju internetskih stranica i programa s Reklamacije.net putem API-ja.

Reklamacije.net još nema potpuni API, ali postepeno dodajemo mnoge stvari, nakon što ih vi zatražite.

Kreiranje novog prigovora

Za poticanje korisnika na pisanje novih prigovora određenim pravnim osobama, koristite URL-ove u ovom obliku: http://reklamacije.net/new/grad_zagreb. Ovo su parametri koje možete dodati tim URL-ovima, bilo u URL-u ili iz oblika:

  • title (naslov) - zadani sažetak novog prigovora
  • default_letter (zadano pismo) - zadani tekst u pismu. Pozdravni tekst (Poštovani...) i potpis (Lijep pozdrav...) su postavljeni oko ovog teksta
  • body (pravna osoba) - kao alternativa default_letter, ovo postavlja cjelokupni tekst prigovora, tako da možete prilagoditi pozdravni tekst i potpis
  • tags (oznake) - razmakom odvojen popis oznaka, tako da ga lakše možete pronaći i povezati kasnije napravljene zahtjeve, npr. prigovor potrošački_broj:12345. Dvotočka predstavlja računalnu oznaku. Vrijednosti računalne oznake mogu uključivati dvotočke, korisne za URL-ove., e.g. prigovor trgovina_lokacija:12345; Dvotočka predstavlja računalnu oznaku; vrijednosti računalne oznake mogu uključivati dvotočke, te korisne URI
RSS (zapravo Atom)

Postoje Atom izvori na većini stranica koje popisuju prigovore, koje možete koristiti kako biste dobili novosti i poveznice u XML formatu. Pronađite URL od Atom izvora na jedan od sljedećih načina:

  • Pronađite RSS link.
  • Potražite <link rel="alternate" type="application/atom+xml"> oznaku u sadržaju HTML-a.
  • Dodajte /feed na početak novog URL-a.

Preciznije rečeno, čak i kompliciraniji upiti za pretraživanje sadrže Atom izvore. S njima možete raditi mnoge stvari, kao što je pretraživanje prema vrsti pravne osobe, prema vrsti datoteke, prema rasponu podataka ili prema statusu. Pogledajte savjete za napredno pretraživanje za detalje.

JSON strukturirani podaci

Dosta internetskih stranica ima JSON verzije, koje omogućavaju preuzimanje podataka o objektima u strukturiranom obliku. Pronađite ih pomoću:

  • Dodajući .json na kraj URL-a.
  • Potražite <link rel="alternate" type="application/json"> oznaku u sadržaju HTML-a.

Prigovori, korisnici i pravne osobe - svi su JSON verzije koje sadrže osnovne informacije o njima. Svaki Atom izvor ima svoj JSON ekvivalent, koji sadrži informacije s popisom događanja unutar izvora.

Popis pravnih osoba

Datoteka s popisom sadrži nazive svih pravnih osoba na Reklamacije.net te je dostupan na poveznici: all-authorities.csv

Zaglavlje popisa pravnih osoba sadrži nazive informacija dostupnih u datoteci:
Name, Short name, URL name, Tags, Home page, Publication scheme, Disclosure log, Notes, Created at, Updated at, Version

Glavni izvor informacija za popis pravnih osoba je NKD nacionalna klasifikacija pravnih osoba, skup podataka koji piše i održava Državni zavod za statistiku. Osim tog popisa koristimo i popis tijela javne vlasti koje održava Povjerenik za informiranje a ove skupove podataka možete pronaći na portalu otvorenih podataka data.gov.hr.

Dolazni API zahtjevi

Dolazni API je dizajniran da pravne osobe mogu dodavati nove zahtjeve u sustav. API trenutno koristi mySociety FOI Register softver koji koristi Alaveteli kao baza svih zahtjeva poslanih nekoj pravnoj osobi. Više tehničkih detalja dostupni su na Alaveteli wiki.

Molimo, kontaktirajte nas ukoliko vam je potreban API dodatak kojeg trenutno nema. Ovo je zaista posao u tijeku i mi dodajmo stvari kad nas to ljudi zatraže.