Kako koristiti MediaWiki sučelje: praktični vodič za hrvatske wikije

Hrvatski wikiji, poput wiki.com.hr, temelje se na popularnoj platformi MediaWiki. Ova platforma pruža programersko sučelje koje omogućuje programerima i istraživačima pristup podacima iz wikija bez potrebe za ručnim pregledavanjem stranica. U nastavku ćemo detaljno objasniti kako koristiti MediaWiki sučelje, prikazati konkretne primjere poziva i dati praktične savjete za rad s podacima.

Osnovni pojmovi i struktura MediaWiki sučelja

MediaWiki sučelje funkcionira na principu HTTP-GET ili HTTP-POST zahtjeva. Svaki zahtjev se šalje na adresu https://wiki.com.hr/api.php uz dodatne parametre koji određuju željenu radnju i format odgovora. Najčešće se koristi format JSON, iako su podržani i XML te drugi formati.

Ključni parametri su:

• action – određuje vrstu operacije, npr. query, search, parse, edit.
• format – definira oblik izlaza, najčešće json.
• Specifični parametri – ovise o odabranoj radnji, npr. titles, prop, list, srsearch.

Primjer osnovnog zahtjeva koji dohvaća osnovne informacije o stranici „Hrvatska“:

https://wiki.com.hr/api.php?action=query&format=json&prop=info&titles=Hrvatska

Dohvat teksta članka – action=query i prop=extracts

Za preuzimanje čistog teksta ili HTML-izdanja članka koristi se radnja query uz parametar extracts. Ovaj parametar omogućuje odabir je li rezultat treba biti u obliku običnog teksta ili HTML-kôda.

https://wiki.com.hr/api.php?action=query&format=json&prop=extracts&titles=Zagreb&explaintext=true

U odgovoru će se nalaziti objekt s naslovom članka i njegovim sadržajem. Ovaj pristup je koristan za izradu aplikacija koje prikazuju informacije iz wikija u vlastitim sučeljima.

Napredne mogućnosti – pretraživanje i filtriranje podataka

MediaWiki sučelje nudi razne opcije za pretraživanje i filtriranje podataka. Najčešće se koristi radnja search s parametrom srsearch koji sadrži ključnu riječ ili frazu. Dodatni parametri omogućuju preciznije filtriranje, poput srnamespace (određuje prostor stranica) i srwhat (pretražuje naslove, opise ili kategorije).

Praktični primjeri i savjeti

Da biste se bolje upoznali s MediaWiki sučeljem, preporučujemo da provjerite dokumentaciju na stranici https://www.mediawiki.org/wiki/API:Main_page. Tamo ćete naći detaljne informacije o svim dostupnim radnjama i parametrima.

U nastavku ćemo dati neke praktične primjere koji će vam pomoći u radu s MediaWiki sučeljem:

• Preuzimanje osnovnih informacija o stranici:

https://wiki.com.hr/api.php?action=query&format=json&prop=info&titles=Hrvatska

• Preuzimanje teksta članka:

https://wiki.com.hr/api.php?action=query&format=json&prop=extracts&titles=Zagreb&explaintext=true

• Pretraživanje stranica po