Isporuka vijesti - Krtica.info

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.

Isporuka e-mailom

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.

Isporuka web servisom

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:

Metoda: HTTP POST
Content-type: application/x-www-form-urlencoded; charset=utf-8

Dakle, 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.

Popis izvora

Krtica trenutno prati 95 medijska izvora:

Oznaka	Naziv	URL
057info.hr	057info	http://www.057info.hr/
24sata.hr	24sata	http://www.24sata.hr/
autoklub.hr	Autoklub.hr	http://www.autoklub.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/
bankamagazine.hr	Banka.hr	http://www.bankamagazine.hr/
barkun.hr	Barkun	http://www.barkun.hr/
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/
danas.hr	Danas.hr	http://danas.net.hr/
dnevnik.hr	Dnevnik.hr	http://dnevnik.hr/
dnevno.hr	Dnevno.hr	http://www.dnevno.hr/
dnevnohr.com	DnevnoHR.com	http://www.dnevnohr.com/
dubrovacki.hr	Dubrovački vjesnik	http://www.dubrovacki.hr/
dubrovniknet.hr	DubrovnikNet	http://www.dubrovniknet.hr/
dw-world.de	Deutsche Welle	http://www.dw-world.de/
ekologija.hr	Ekologija.hr	http://ekologija.hr/
evarazdin.hr	eVarazdin.hr	http://www.evarazdin.hr/
ezadar.hr	eZadar	http://www.ezadar.hr/
facebook.com	Facebook	http://www.facebook.com/
fashion.hr	Fashion.hr	http://www.fashion.hr/
forum.hr	Forum.hr	http://www.forum.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/
h-alter.org	H-Alter	http://www.h-alter.org/
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/
javno.com	Javno	http://www.javno.com/
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/
liderpress.hr	Lider press vijesti	http://www.liderpress.hr/
limun.hr	Limun.hr	http://www.limun.hr/
metro-portal.hr	Metro-portal.hr	http://metro-portal.hr/
mojblog.hr	MojBlog.hr	http://www.mojblog.hr/
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/
novilist.hr	Novi list	http://www.novilist.hr/
ordinacija.hr	Ordinacija.hr	http://www.ordinacija.hr/
osijek031.com	Osijek031.com	http://www.osijek031.com/
otvoreni.hr	Otvoreni radio	http://otvoreni.hr/
pcchip.hr	PC chip magazin	http://www.pcchip.hr/
poslovni.hr	Poslovni.hr	http://www.poslovni.hr/
privredni.hr	Privredni vjesnik	http://www.privredni.hr/
racunalo.com	Racunalo.com	http://www.racunalo.com/
radio101.hr	Radio 101	http://www.radio101.hr/
radiocibona.hr	Radio Cibona	http://www.radio-cibona.hr/
regionalexpress.hr	Regional Express	http://regionalexpress.hr/
rijekadanas.com	Rijeka Danas	http://www.rijekadanas.com/
rtl.hr	RTL Televizija	http://www.rtl.hr/
seebiz.eu	SEEbiz.eu	http://www.seebiz.eu/
slobodnadalmacija.hr	Slobodna Dalmacija	http://www.slobodnadalmacija.hr/
solin.hr	Solin.hr	http://www.solin.hr/
sportal.hr	sportal.hr	http://www.sportal.hr/
sportnet.hr	Sportnet.hr	http://www.sportnet.hr/
sportske.hr	Sportske vijesti	http://sportske.hr/
sportskenovosti.hr	Sportske novosti	http://sportske.jutarnji.hr/
story.hr	Story	http://www.story.hr/
sutra.hr	Sutra.hr	http://www.sutra.hr/
teen385.com	Teen385	http://www.teen385.com/
totalportal.hr	TotalPortal.hr	http://www.totalportal.hr/
tportal.hr	T-portal	http://www.tportal.hr/
twitter.com	Twitter	http://www.twitter.com/
varazdin-online.com	Varaždin Online	http://www.varazdin-online.com/
vecernji.hr	Vecernji.hr	http://www.vecernji.hr/
vidi.hr	Vidi	http://www.vidi.hr/
vidilab.com	VidiLab IT	http://www.vidilab.com/
vjesnik.hr	Vjesnik	http://www.vjesnik.hr/
voanews.com	VOA News	http://www.voanews.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.

Popis kategorija

Krtica sve vijesti razvrstava u 17 kategorija:

Oznaka	Naziv
bad-news	Crna kronika
business	Gospodarstvo
croatia	Hrvatska
culture	Kultura
entertainment	Zanimljivosti
health	Zdravlje
lifestyle	Lifestyle
movies	Film
music	Glazba
opinion	Kolumne
politics	Politika
sci-tech	Znanost
showbiz	Scena
sport	Sport
travel	Putovanja
wheels	Auto-moto
world	Svijet

Kategorije vijesti su stalne i ne mijenjaju se.

Pomoćni servisi

Osim isporuke vijesti, Krtica posjeduje i nekoliko servisa čija je zadaća olakšati prikaz i manipulaciju vijesti na klijentskoj strani.

Servis za dohvaćanje skalirane slike

Č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://www.krtica.info/api/image

Parametri:

id - Krtičin UUID vijesti
width - maksimalna širina slike
height - maksimalna visina slike

Servis za interaktivnu pretragu

Partneri koji zatraže tu mogućnost, mogu dobiti programski pristup sustavu za upite u Krtičinu bazu vijesti u kojoj se nalaze sve vijesti unazad 90 dana. Format upita je istovjetan onome koji se unosi na glavnoj Krtičinoj tražilici.