Aiuto:Utilizzo API
Esempi di Query Mediawiki
Per interagire con un'API MediaWiki, come quella fornita per https://wiki.offworld.it/api.php?, è possibile eseguire varie query per recuperare pagine, cercare termini e altro. Di seguito alcuni esempi di query che potresti utilizzare.
1. Recuperare una Pagina Specifica per Titolo
Per ottenere il contenuto di una pagina specifica tramite il suo titolo:
https://wiki.offworld.it/api.php?action=query&prop=revisions&titles=TitoloPagina&rvprop=content&formatversion=2&format=json
- Sostituire `TitoloPagina` con il titolo della pagina che si desidera recuperare.
- `rvprop=content` indica che si desidera ottenere il contenuto della pagina.
- `formatversion=2` e `format=json` specificano il formato della risposta.
2. Ricerca di Pagine Contenenti Termini Specifici
Per cercare pagine che contengono termini specifici:
https://wiki.offworld.it/api.php?action=query&list=search&srsearch=TermineDiRicerca&format=json
- Sostituire `TermineDiRicerca` con il termine che si sta cercando.
- `list=search` specifica che si sta eseguendo una query di ricerca.
- `srsearch=TermineDiRicerca` è il termine di ricerca.
3. Recuperare Più Pagine tramite ID delle Pagine
Se si hanno gli ID delle pagine, è possibile recuperare più pagine in una singola query:
https://wiki.offworld.it/api.php?action=query&pageids=123|456|789&prop=revisions&rvprop=content&formatversion=2&format=json
- Sostituire `123|456|789` con gli effettivi ID delle pagine, separati da `|`.
- Questo esempio richiede anche il contenuto di queste pagine.
4. Elencare le Categorie su una Pagina Specifica
Per ottenere le categorie associate a una pagina specifica:
https://wiki.offworld.it/api.php?action=query&prop=categories&titles=TitoloPagina&format=json
- Sostituire `TitoloPagina` con il titolo della pagina.
5. Ottenere le Modifiche Recenti
Per recuperare le modifiche recenti in tutta la wiki:
https://wiki.offworld.it/api.php?action=query&list=recentchanges&rcprop=title|timestamp|user&format=json
- `list=recentchanges` specifica che si sta interrogando sulle modifiche recenti.
- `rcprop=title|timestamp|user` richiede dettagli come il titolo della pagina modificata, il timestamp della modifica e l'utente che ha effettuato la modifica.
Ricordati, quando costruisci le tue query:
- Sempre codificare i parametri dell'URL per garantire che siano interpretati correttamente dal server.
- Regola i parametri come `format=json` secondo le necessità, a seconda di come desideri elaborare la risposta.
- L'API MediaWiki è molto potente e flessibile; consulta la documentazione dell'API MediaWiki per query e parametri più avanzati.