Isporuka vijesti
Tehnička dokumentacija
Prijenos vijesti od Krtice prema zainteresiranim stranama vrši se usporedo sa njihovim prikupljanjem, bez ikakve zadrške, jednom od dogovorenih metoda. Trenutno je podržana isporuka e-mailom i putem web servisa, a po potrebi je moguće podržati i dodatne metode isporuke.
Za klijente koji žele osobno primati zatražene vijesti sa Krtice, nudimo mogućnost isporuke vijesti putem standardnog e-maila. Zbog specifičnosti sučelja, preporučuje se na ovaj način pretplata samo na uski set vijesti (npr. specijalizirane ključne riječi) ili pak korištenje e-mail klijenta sa mogućnošću odvojene klasifikacije pristiglih poruka (većina klijenata ima tu mogućnost). Klasifikaciju pristiglih poruka olakšati će i detaljne informacije o isporučenoj vijesti u zaglavlju e-mail poruke.
Želite li vijesti primati na ovakav način, dojavite nam samo kriterije koje moraju zadovoljavati vijesti koje su vam interesantne, te svoju e-mail adresu.
Preporučljiva metoda prijema veće količine vijesti sa Krtice je implementacija jednostavnog web servisa na vašem poslužitelju koji će primiti vijest sa Krtice u standarnom formatu i pohraniti je direktno u vašu bazu podataka. Jednom kada je vijest uspješno primljena, ne postoje nikakva ograničenja vezana uz njeno daljnje korištenje sa vaše strane.
Parametri kojima Krtica poziva web servis su sljedeći:
HTTP POSTapplication/x-www-form-urlencoded; charset=utf-8Dakle, web servis je potrebno implementrati na isti način kao da prima zahtjev sa popunjene web forme. U tijelu poziva, isporučena vijest biti će predstavljena sljedećim parametrima:
| Naziv | Opis | Primjer |
|---|---|---|
| id | Krtičin UUID vijesti | a0c62eb0-8dac-4548-9bcc-37c754c92239 |
| source | jedinstvena slovčana oznaka izvora (domena) koji je vijest objavio (popis) | jutarnji.hr |
| title | Naslov vijesti | KUKURIKU: Oporba je pokazala zavidnu gastronomsku kulturu |
| url | puni URL do vijesti na izvoru koji je vijest objavio | http://www.jutarnji.hr/j2/dobrahrana/clanak/art-2009,7,26,,170761.jl |
| publishing_date | vrijeme za koje izvor tvrdi da je tada objavio vijest | 2009-04-24 12:33:56 +0200 |
| category | oznaka kategorije vijesti (popis) | lifestyle |
| ripped_date | vrijeme kada je Krtice preuzela vijest | 2009-04-24 12:33:56 +0200 |
| description | kratki uvod u vijest, jedna ili dvije rečenice | Kukurikova vinska karta jedna je od kompetentnijih u Hrvatskoj, s jako velikim izborom vina na čaše. |
| intro_text | duži, logički uvod u vijest duljine otprilike 20% punog teksta vijesti | Kukurikova vinska karta jedna je od kompetentnijih u Hrvatskoj, s jako velikim izborom vina na čaše U ova, ponovo hiperpolitička vremena, čak se i kolumne o hrani ne mogu baš uvijek obraniti od političkih konotacija. Uostalom, u tradiciji je novije hrvatske politike da njeni glavni protagonisti donose važne odluke i sklapaju bitne sporazume baš u restoranima (netko zloban sada bi mogao reći da se to vidljivo odražava na sadržaj tih odluka ili sporazuma). Ovih je dana u sam fokus naše gastropolitičke scene došao kastavski Kukuriku, gdje su, kako znamo, lideri glavnih oporbenih stranaka postigli načelni dogovor o zajedničkom nastupu na narednim parlementarnim izborima. Napredak u dobrom ukusu Izbor Kukurikua za mjesto na kojem je taj sporazum pripremljen pokazuje značajan napredak u dobrom ukusu kod hrvatskih političara: u protekla su se dva desetljeća značajnije odluke donosile u gastronomski puno zapuštenijim mjestima, poput podruma zagrebačkog Muzeja za umjetnost i obrt, ili jedne solidne ali dosta rustikalne poluroštiljarne blizu Kvaternikova trga. |
| image_url | puni URL do slike vijesti na originalnom izvoru (ako je objavljena vijest imala sliku) | http://www.jutarnji.hr/ephresources/images/2009/07/25/kukuriku-v.jpg |
| keywords | cca 10-ak ključnih riječi odvojenih zarezom koje opisuju tematiku članka | kukuriku, vina, restoran, čaša, kukurikuova, kukurin, svjež, kompetentnijih, kvarnerska, zaljev |
Vijest se na ovako implementirani web servis isporučuje istovremeno kada je Krtica prikupi sa portala, a ukoliko servis iz bilo kojeg razloga tada nije dohvatljiv, isporuka će se pokušati ponoviti svakih 15 minuta sve dok ne uspije (uspješno primljena vijest podrazumjeva povratni HTTP odgovor 200). Ukoliko servis ne procesira primitak vijesti u zadanom roku od 10 sekundi, vijest se označava kao neuspješno isporučena i njena će isporuka biti ponovljena kroz 15 minuta. U rijetkim situacijama kada web servis uspije primiti cijelu vijest, ali to učini izvan zadanog vremena, moguće je da ponovno primi istu vijest nakon 15 minuta. Ovakve je "duplikate" moguće detektirati po istom UUID-u vijesti i potrebno ih je ignorirati.
Krtica trenutno prati 145 medijska izvora:
| Oznaka | Naziv | URL | |
|---|---|---|---|
| 057info.hr | 057info | http://www.057info.hr/ | |
| 24sata.hr | 24sata | http://www.24sata.hr/ | |
| 24sata.info | 24sata.info | http://www.24sata.info/ | |
| advance.hr | Advance.hr | http://www.advance.hr/ | |
| aktual.hr | Aktual.hr | http://www.aktual.hr/ | |
| aktualno.hr | Aktualno.hr | http://www.aktualno.hr/ | |
| autonet.hr | AutoNet | http://www.autonet.hr/ | |
| autoportal.hr | Autoportal.hr | http://www.autoportal.hr/ | |
| autosport.hr | Autosport.hr | http://www.autosport.hr/ | |
| autoweb.hr | Autoweb.hr | http://www.autoweb.hr/ | |
| b92.net | B92 | http://www.b92.net/ | |
| bankamagazine.hr | Banka.hr | http://www.bankamagazine.hr/ | |
| barkun.hr | Barkun | http://www.barkun.hr/ | |
| beta.rs | Beta press | http://www.beta.rs/ | |
| bitno.ba | Bitno.ba | http://www.bitno.ba/ | |
| biznis.ba | Biznis.ba | http://www.biznis.ba/ | |
| blic.rs | Blic Online | http://www.blic.rs/ | |
| bljesak.info | Bljesak.info | http://www.bljesak.info/ | |
| blog.hr | Blog.hr | http://www.blog.hr/ | |
| bloger.hr | Bloger.hr | http://www.bloger.hr/ | |
| bug.hr | Bug On Line | http://www.bug.hr/ | |
| business.hr | Business.hr | http://business.hr/ | |
| croatiabiz.com | Croatiabiz | http://www.croatiabiz.com/ | |
| culturenet.hr | CultureNet.hr | http://www.culturenet.hr/ | |
| dalje.com | Dalje.com | http://www.dalje.com/ | |
| danas.hr | Danas.hr | http://danas.net.hr/ | |
| danas.rs | Danas | http://www.danas.rs/ | |
| dnevni-list.ba | Dnevni list | http://www.dnevni-list.ba/ | |
| dnevniavaz.ba | Dnevni Avaz | http://www.dnevniavaz.ba/ | |
| dnevnik.ba | Dnevnik.ba | http://www.dnevnik.ba/ | |
| dnevnik.hr | Dnevnik.hr | http://dnevnik.hr/ | |
| dnevno.hr | Dnevno.hr | http://www.dnevno.hr/ | |
| dubrovacki.hr | Dubrovački vjesnik | http://www.dubrovacki.hr/ | |
| dubrovniknet.hr | DubrovnikNet | http://www.dubrovniknet.hr/ | |
| dubrovnikportal.com | dubrovnikportal | http://www.dubrovnikportal.com/ | |
| dw-world.de | Deutsche Welle | http://www.dw-world.de/ | |
| e-novine.com | e-Novine | http://www.e-novine.com/ | |
| ekologija.hr | Ekologija.hr | http://ekologija.hr/ | |
| energetika-net.com | ENERGETIKA-NET | http://energetika-net.com/ | |
| evarazdin.hr | eVarazdin.hr | http://www.evarazdin.hr/ | |
| ezadar.hr | eZadar | http://www.ezadar.hr/ | |
| facebook.com | http://www.facebook.com/ | ||
| fashion.hr | Fashion.hr | http://www.fashion.hr/ | |
| fokus.ba | Fokus | http://www.fokus.ba/ | |
| forum.24sata.hr | 24sata.hr Forum | http://www.24sata.hr/ | |
| forum.hr | Forum.hr | http://www.forum.hr/ | |
| forum.index.hr | Index Forum | http://www.index.hr/forum/ | |
| forum.net.hr | Net.hr Forum | http://forum.net.hr/ | |
| forum.tportal.hr | T-portal Forum | http://www.tportal.hr/ | |
| forum.vecernji.hr | Vecernji.hr Forum | http://www.vecernji.hr/ | |
| glas-slavonije.hr | Glas Slavonije | http://www.glas-slavonije.hr/ | |
| glasdalmacije.hr | GlasDalmacije | http://www.glasdalmacije.hr/ | |
| glasistre.hr | Glas Istre | http://www.glasistre.hr/ | |
| globus.com.hr | Globus | http://globus.jutarnji.hr/ | |
| gol.hr | Gol.hr | http://gol.hr/ | |
| h-alter.org | H-Alter | http://www.h-alter.org/ | |
| hanfa.hr | Hanfa | http://www.hanfa.hr/ | |
| hercegovina.info | Hercegovina.info | http://www.hercegovina.info/ | |
| hgk.hr | Hrvatska Gospodarska Komora | http://www.hgk.hr/ | |
| hkr.hr | Hrvatski katolički radio | http://www.hkr.hr/ | |
| hrportfolio.com | HrPortfolio.com | http://www.hrportfolio.com/ | |
| hrt.hr | HRT | http://www.hrt.hr/ | |
| ict.hr | Information Technology - Internet Monitor | http://www.ict.hr/ | |
| index.hr | Index.hr | http://www.index.hr/ | |
| it-review.hr | IT-review.hr | http://it-review.hr/ | |
| jatrgovac.com | Ja TRGOVAC | http://www.jatrgovac.com/ | |
| javno.hr | Javno.hr | http://www.javno.hr/ | |
| jutarnji.hr | Jutarnji.hr | http://www.jutarnji.hr/ | |
| karlovacki-tjednik.hr | Karlovački tjednik | http://www.karlovacki-tjednik.hr/ | |
| kastela.org | Kastela.org | http://www.kastela.org/ | |
| klik.hr | KL!K.hr | http://www.klik.hr/ | |
| koprivnica.net | Koprivnica.net | http://koprivnica.net/ | |
| korzo.net | Korzo.net | http://www.korzo.net/ | |
| kulturpunkt.hr | Kulturpunkt | http://www.kulturpunkt.hr/ | |
| kurir-info.rs | Kurir | http://www.kurir-info.rs/ | |
| liderpress.hr | Lider press vijesti | http://www.liderpress.hr/ | |
| limun.hr | Limun.hr | http://www.limun.hr/ | |
| lupiga.com | Lupiga | http://www.lupiga.com/ | |
| metro-portal.hr | Metro-portal.hr | http://metro-portal.hr/ | |
| mojblog.hr | MojBlog.hr | http://www.mojblog.hr/ | |
| mondo.rs | Mondo | http://www.mondo.rs/ | |
| monitor.hr | Internet Monitor | http://www.monitor.hr/ | |
| muzika.hr | Muzika.hr | http://www.muzika.hr/ | |
| mvinfo.hr | Moderna vremena Info | http://www.mvinfo.hr/ | |
| nacional.hr | Nacional | http://www.nacional.hr/ | |
| neon.com.hr | neon. | http://www.neon.com.hr/ | |
| net.hr | Net.hr | http://www.net.hr/ | |
| news.carnet.hr | Usenet | http://news.carnet.hr/ | |
| nezavisne.com | Nezavisne novine | http://www.nezavisne.com/ | |
| nogometni-magazin.com | Nogometni magazin | http://www.nogometni-magazin.com/ | |
| novilist.hr | Novi list | http://www.novilist.hr/ | |
| novosti.rs | Večernje novosti | http://www.novosti.rs/ | |
| ordinacija.hr | Ordinacija.hr | http://www.ordinacija.hr/ | |
| osijek031.com | Osijek031.com | http://www.osijek031.com/ | |
| oslobodjenje.ba | Oslobođenje | http://www.oslobodjenje.ba/ | |
| otvoreni.hr | Otvoreni radio | http://otvoreni.hr/ | |
| pcchip.hr | PC chip magazin | http://www.pcchip.hr/ | |
| politika.rs | POLITIKA Online | http://www.politika.rs/ | |
| politikaplus.com | Politika Plus | http://www.politikaplus.com/ | |
| portaloko.hr | Portal Oko | http://www.portaloko.hr/ | |
| poskok.info | Poskok Online - Hercegovina | http://www.poskok.info/ | |
| poslovni.hr | Poslovni.hr | http://www.poslovni.hr/ | |
| poslovniportal.ba | Poslovni portal | http://www.poslovniportal.ba/ | |
| poslovnipuls.com | PoslovniPuls | http://www.poslovnipuls.com/ | |
| pravda.rs | Pravda | http://www.pravda.rs/ | |
| pressonline.rs | Press Online | http://www.pressonline.rs/ | |
| privredni.hr | Privredni vjesnik | http://www.privredni.hr/ | |
| racunalo.com | Racunalo.com | http://www.racunalo.com/ | |
| radio-varazdin.hr | Radio Varaždin | http://www.radio-varazdin.hr/ | |
| radio101.hr | Radio 101 | http://www.radio101.hr/ | |
| radiocibona.hr | Radio Cibona | http://www.radio-cibona.hr/ | |
| regionalexpress.hr | Regional Express | http://regionalexpress.hr/ | |
| regionalni.com | 7 Plus Regionalni tjednik | http://regionalni.com/ | |
| rep.hr | Rep.hr | http://www.rep.hr/ | |
| rijekadanas.com | Rijeka Danas | http://www.rijekadanas.com/ | |
| rtl.hr | RTL Televizija | http://www.rtl.hr/ | |
| rts.rs | RTS | http://www.rts.rs/ | |
| seebiz.eu | SEEbiz.eu | http://www.seebiz.eu/ | |
| slobodna-bosna.ba | Slobodna Bosna | http://www.slobodna-bosna.ba/ | |
| slobodnadalmacija.hr | Slobodna Dalmacija | http://www.slobodnadalmacija.hr/ | |
| solin.hr | Solin.hr | http://www.solin.hr/ | |
| sportnet.hr | Sportnet | http://www.hrsport.net/ | |
| sportskenovosti.hr | Sportske novosti | http://sportske.jutarnji.hr/ | |
| story.hr | Story | http://www.story.hr/ | |
| suvremena.hr | Suvremena trgovina | http://www.suvremena.hr/ | |
| tanjug.rs | Tanjug | http://www.tanjug.rs/ | |
| teen385.com | Teen385 | http://www.teen385.com/ | |
| tportal.hr | T-portal | http://www.tportal.hr/ | |
| twitter.com | http://www.twitter.com/ | ||
| varazdin-online.com | Varaždin Online | http://www.varazdin-online.com/ | |
| varazdinske-vijesti.hr | Varaždinske vijesti | http://varazdinske-vijesti.hr/ | |
| vecernji.ba | Vecernji.ba | http://www.vecernji.ba/ | |
| vecernji.hr | Vecernji.hr | http://www.vecernji.hr/ | |
| vesti-online.com | Vesti online | http://www.vesti-online.com/ | |
| vidi.hr | Vidi | http://www.vidi.hr/ | |
| vidilab.com | VidiLab IT | http://www.vidilab.com/ | |
| vjesnik.hr | Vjesnik | http://www.vjesnik.hr/ | |
| vlada.hr | Vlada RH | http://vlada.hr/ | |
| voanews.com | VOA News | http://www.voanews.com/ | |
| volim-novac.hr | Volim Novac | http://volim-novac.hr/ | |
| vreme.com | Vreme | http://www.vreme.com/ | |
| zadarinfo.com | ZDinfo | http://www.zadarinfo.com/ | |
| zagorje.com | Zagorje.com | http://zagorje.com/ | |
| zagrebancija.com | Zagrebancija | http://zagrebancija.com/ | |
| zamirzine.net | ZaMirZINE | http://www.zamirzine.net/ |
Bitno je uočiti da se broj praćenih izvora neprestano povećava, te je potrebno omogućiti prihvat vijesti na način da se predvidi buduće pojavljivanje vijesti i sa drugih izvora koji nisu trenutno pobrojani.
Krtica sve vijesti razvrstava u 19 kategorija:
| Oznaka | Naziv |
|---|---|
| bad-news | Crna kronika |
| bih | BiH |
| business | Gospodarstvo |
| croatia | Hrvatska |
| culture | Kultura |
| entertainment | Zanimljivosti |
| health | Zdravlje |
| lifestyle | Lifestyle |
| movies | Film |
| music | Glazba |
| opinion | Kolumne |
| politics | Politika |
| sci-tech | Znanost |
| serbia | Srbija |
| showbiz | Scena |
| sport | Sport |
| travel | Putovanja |
| wheels | Auto-moto |
| world | Svijet |
Kategorije vijesti su stalne i ne mijenjaju se.
Osim isporuke vijesti, Krtica posjeduje i nekoliko servisa čija je zadaća olakšati prikaz i manipulaciju vijesti na klijentskoj strani.
Često je sliku neke vijesti potrebno prikazati u točno određenim dimenzijama, najčešće zato da bi se uklopila u postojeći web design. Krtica za tu upotrebu nudi servis koji će za svaku vijest isporučiti njenu sliku (ili logo izvora koji je vijest objavio ukoliko vijest nema slike) u dimenzijama koje ne prekoračuju zadanu širinu i visinu. Skalirana slika će zadržati omjer širine i visine, te će biti skalirana na najveće moguće dimenzije unutar zadanih vrijednosti (bounding rectangle).
URL adresa servisa:
http://localhost:8080/mole/api/news/{id vijesti}/imageParametri:
id - Krtičin UUID vijestiwidth - maksimalna širina slikeheight - maksimalna visina slikePrimjer:
http://www.krtica.info/api/news/ad09133d-aa8f-4fe5-90b4-dadf91390175/image?width=80&height=80