Wikirandom API

Wikirandom fornisce una semplice API che consente ad altre Applicazioni Web di ottenere una lista di pagine casuali da Wikipedia attraverso una richiesta HTTP. L'API di Wikirandom è, liberamente disponibile per usi non commerciali, aggiunge funzionalità alla API di MediaWiki, e supporta il formato JSON.

Richiesta

• La richiesta dev'essere del tipo GET.
• Non è necessaria l'autenticazione.

Metodi

L'API consiste di due metodi:

JSON

Restituisce una variabile contenente coppie di URL e di titoli di pagine Wikipedia scelti a caso.
URL: http://www.wikirandom.org/json
PARAMETRI:

• languages. Opzionale. Se non è impostato, è predefinito come 'en'. Specifica le lingue tra cui si vuole scegliere le pagine. È possibile impostare più di una linga separandole con virgole. Valori accettati: en (English), de (German), fr (French), pl (Polish), ja (Japanese), it (Italian), nl (Dutch), pt (Portuguese), es (Spanish), sv (Swedish), ru (Russian), zh (Chinese), no (Norwegian (Bokmål)), fi (Finnish), vo (Volapük), ca (Catalan), ro (Romanian), tr (Turkish). Si può usare lo stesso valore più di una volta per aumentare le probabilità che sia scelto.
• pages. Opzionale. Se non è impostato, è predefinito come 1. Specifica il numero di pagine casuali da cercare. Valori accettati: da 1 a 10.
• callback. Opzionale. Se è impostato, il codice restituito sarà racchiuso in una funzione chiamata come questo valore. Questo parametro è necessario per inserire i dati restituiti in una pagina direttamente tramite JavaScript. Per un esempio sull'utilizzo, vedi il codice nel box 'Per il tuo sito'.

ESEMPIO:

1. Una richiesta diretta a questo URL:
   http://www.wikirandom.org/json?languages=en,en,it,es&pages=2
   restituisce il seguente oggetto JSON:
   { "status": true, "data": [ { "url": "http://en.wikipedia.org/wiki/RANDOM_PAGE_1", "title": "RANDOM_TITLE_1" }, { "url": "http://en.wikipedia.org/wiki/RANDOM_PAGE_2", "title": "RANDOM_TITLE_2" } ] }.
   Le pagine trovate saranno per il 50% in inglese, il 25% in italiano, e il 25% in spagnolo.

COUNT

Restituisce il conteggio totale delle pagine cercate da Wikirandom, sia sul sito che attraverso la API.
URL: http://www.wikirandom.org/json/count
PARAMETRI:

• callback. Opzionale. Se è impostato, il codice restituito sarà racchiuso in una funzione chiamata come questo valore. Questo parametro è necessario per inserire i dati restituiti in una pagina direttamente tramite JavaScript. Per un esempio sull'utilizzo, vedi il codice nel box 'Per il tuo sito'.

ESEMPIO:

1. Una richiesta diretta a questo URL:
   http://www.wikirandom.org/json/count
   restituisce il seguente oggetto JSON:
   { "internal": TOTAL_RANDOM_PAGES_FETCHED_ON_SITE, "api": TOTAL_RANDOM_PAGES_FETCHED_BY_API }