O našim API

Uvod

Ova stranica objašnjava kako programeri mogu da nateraju druge veb stranice i softvere da stupe u interakciju sa dumeditë preko “PJD”.

dumeditë još uvek nema potpun PJD, ali postepeno dodajemo mnogo stvari koje su slične u upotrebi PJD-u kako se traži.

Povezivanje sa novim zahtevima

Da biste podstakli svoje korisnike da prilože linkove određenom javnom organu, koristite URL adrese u obliku /sr/new/%2Fsr%2Fnev%2Fop%C5%A1tina_%C4%91akovica. Ovo su parametri koje možete da dodate tim URL-ovima, bilo u URL-u ili iz obrasca.

• naslov - podrazumevani sažetak novog zahteva.
• automatsko_pismo - podrazumevani tekst pisma. Ovo uključuje i pozdrav (ili “Dragi/e…”) i (Vaš) potpis.
• sadržaj - kao alternativa za automatsko_pismo, ovo postavlja podrazumevani ceo tekst zahteva, tako da možete prilagoditi pozdrav i potpis.
• tags - lista oznaka razdvojenih razmakom, tako da možete pronaći i povezati sve naknadne zahteve, npr. openlilocal costing_id:12345. : označava da je to tehnička oznaka. Vrednosti tehničkih oznaka mogu takođe da uključuju dvotačke, korisne za URL.

RSS (ili Atom) feedovi

Na većini stranica postoje Atom feedovi na kojima se navode zahtevi za PJD, koje možete koristiti da biste dobili ažuriranja i linkove u KSML formatu. Pronađite URL Atom fida na sledeće načine:

• Potražite veze za RSS feed.
• Ispitajte oznaku <link rel="alternate" type="application/atom+xml"> u zaglavlju HTML-a.
• Dodajte /feed na početak druge URL adrese.

Konkretno, čak i komplikovani upiti za pretragu imaju Atom feedove. Sa njima možete da radite razne stvari, kao što su upiti po ovlašćenju, tipu fajla, rasponu datuma ili statusu. Pogledajte savete za naprednu pretragu za detalje.

JSON strukturirani podaci

Dosta stranica ima JSON verzije, koje vam omogućavaju da preuzmete informacije o objektima u strukturiranom obliku. Pronađite ih na sledeći način:

• Dodajte .json na kraj URL-a.
• Potražite oznaku <link rel="alternate" type="application/json"> u zaglavlju HTML-a.

Zahtevi, korisnici i javni organi imaju JSON verzije koje sadrže osnovne informacije o njima. Svaki Atom feed ima JSON ekvivalent koji sadrži informacije o listi događaja u feedu.

Tabela svih javnih organa

Dostupna je tabela sa spiskom svih organa u dumeditë: all-authorities.csv

5. PJD za pisanje

PJD za pisanje je dizajniran da ga koriste vlasti za kreiranje sopstvenih zahteva u sistemu. Više tehničkih informacija o PJD-u za pisanje dostupno je na stranici Wikipedije Alaveteli.