Kuidas MediaWiki API-t kasutada

MediaWiki API on hästi dokumenteeritud arendustööriistade komplekt, mis suudab teha enamiku ülesandeid ühe skriptiga. API-d kasutatakse tavaliselt vikis kasutatavate automatiseeritud tööriistade arendamiseks. MediaWiki API-d saavad hõlpsasti kasutada enamik keeli, eriti PHP (kõvera funktsioonid), Perl ja mõned teised.

1
Lugege MediaWiki API dokumentatsiooni. See asub ‘api.php’ samas kataloogis, kus tavaline index.php. Näide: https://www.Selgitatud.com/api.php.

2
Valige väljundvorming. MediaWiki pakub andmeväljundit JSON, JSONFM, PHP (serialized format), PHPFM, WDDX, WDDXFM, XML, XMLFM, YAML, YAMLFM ja RAWFM kujul. Vormingud, mille järelliide on “FM”, on HTML-is ilusti trükitud.

3
Valige toiming. MediaWiki API toetab järgmisi toiminguid: abi – vaadake abiekraani sisselogimist – Logige sisse MediaWikiopensearchi – Rakendage opensearch protokoll. (Kõigil MediaWiki installidel pole seda).feedwatchlist – tagastab jälgimisloendi feed.query – sellel on palju valikuid. Nende kohta vaadake MediaWiki API dokumentatsiooni.

4
Valige päring või loend. Lisaks tavatoimingutele toetab MediaWiki erinevaid päringuid ja loendeid, näiteks loendilehti, mis sisaldavad linki teisele artiklile, hiljutiste muudatuste arvu erinevusi, kaastöid jne.

5
Edastage postitatud andmed API-le, kasutades CURL-i või mõnda muud tööriista, mis võimaldab teil kasutada skripti jaoks POST-meetodit. GET-meetod võib samuti toimida.

6
Säilitage kindlasti rakendusele saadetud küpsised (mõned skriptid/rakendused võivad soovida selle salvestada alamkausta.

7
MediaWiki kasutajaliidesega suhtlemisel pidage meeles, et enamikul redigeerimislehtedel on redigeerimisluba. Redigeerimisluba kasutatakse redigeerimise kokkupõrgete määramiseks ja mõne juba tehtud redigeerimise alistamise vältimiseks (seda kasutatakse ka tagasipööramisel.). Pidage meeles, et viki kasutajaliidese kasutamisel on lihtsam viltu minna. Pidage meeles kõiki kasutatavaid regexe, et olla kindel, et need annavad ainult soovitud tulemuse.

8
Lugege viki saadetud tulemusi. Tulemused saadetakse teile HTTP vastusena, mida saavad lugeda paljud parserid. Olge valitud vormingu eest eriti ettevaatlik. Veenduge, et kasutate selle vormingu jaoks sobivat parserit. Tavaliselt on hea tava anda vorming MediaWikile selgesõnaliselt välja isegi siis, kui sellel on vaikevorming, mida soovite kasutada.