MediaWiki API help

Qué aición facer.

abusefiltercheckmatch

Comprobar si un filtru d'abusos casa con un conxuntu de variables, una edición o un socesu rexistráu d'AbuseFilter.

abusefilterchecksyntax

Comprobar la sintaxis d'un filtru de la Peñera d'abusos.

abusefilterevalexpression

Evaluar una espresión de la Peñera d'abusos.

abusefilterunblockautopromote

Desbloquia a un usuariu de recibir autopromociones como consecuencia de la peñera d'abusos.

abuselogprivatedetails

Ver detalles privaos d'una entrada de AbuseLog.

acquiretempusername

Acquire a temporary user username and stash it in the current session, if temp account creation is enabled and the current user is logged out. If a name has already been stashed, returns the same name.

antispoof

Comprobar un nome d'usuariu escontra les comprobaciones de normalización AntiSpoof.

block

Bloquiar a un usuariu.

centralauthtoken

Algamar un centralauthtoken pa facer una solicitú autenticada a una wiki anexa.

centralnoticecdncacheupdatebanner

Solicitar la purga del conteníu d'anuncios guardáu na caché CDN (frontal) pa usuarios anónimos, pa la llingua y anunciu solicitáu

centralnoticechoicedata

Obtener los datos necesarios pa escoyer un cartelu pa un proyeutu y llingua daos

centralnoticequerycampaign

Obtener tolos parámetros de configuración d'una campaña.

changeauthenticationdata

Camudar los datos d'identificación del usuariu actual.

changecontentmodel

Change the content model of a page

checktoken

Comprueba la validez d'un pase dende action=query&meta=tokens.

clearhasmsg

Llimpia la marca hasmsg del usuariu actual.

clientlogin

Aniciar sesión na wiki usando'l fluxu interactivu.

communityconfigurationedit

Change the content of a configuration provider in Community configuration

compare

Llograr la diferencia ente dos páxines.

createaccount

Crear una cuenta d'usuariu nueva.

createlocalaccount

Forcibly create a local account. The central account must exist.

cxdelete

Desaniciar un borrador de traducción creáu usando la estensión Content Translation.

cxtoken

Recibir pases (tokens) JWT pa identificase col cxserver.

delete

Desaniciar una páxina.

deleteglobalaccount

Desaniciar un usuariu global.

discussiontoolsedit

Post a message on a discussion page.

discussiontoolsfindcomment

Find a comment by its ID or name.

discussiontoolsgetsubscriptions

Get the subscription statuses of given topics.

discussiontoolssubscribe

Subscribe (or unsubscribe) to receive notifications about a topic.

discussiontoolsthank

Send a public thank-you notification for a comment.

echocreateevent

Manually trigger a notification to a user

echomarkread

Marcar les notificaciones como lleíes pal usuariu actual.

echomarkseen

Marcar les notificaciones como vistes pal usuariu actual.

echomute

Mute or unmute notifications from certain users or pages.

edit

Create and edit pages.

editmassmessagelist

Editar una llista d'entrega de mensaxes en masa.

emailuser

Unviar un corréu electrónicu a un usuariu.

expandtemplates

Expands all templates within wikitext.

featuredfeed

Devuelve una canal de noticies de conteníu destacáu

feedcontributions

Returns a user's contributions feed.

feedrecentchanges

Returns a recent changes feed.

feedwatchlist

Returns a watchlist feed.

filerevert

Revert a file to an old version.

globalblock

Bloquiar o desbloquiar a un usuariu globalmente.

globalpreferenceoverrides

Cambiar les variaciones llocales de les preferencies globales del usuariu actual.

globalpreferences

Camudar les preferencies globales del usuariu actual.

globaluserrights

Amestar/desaniciar un usuariu a/de grupos globales.

growthmanagementorlist

Manage information in the structured mentor list (usually stored in MediaWiki:GrowthMentors.json). This module can be used by both current and future mentors (to add themselves or change their details) and administrators (for all users).

growthmentordashboardupdatedata

Schedule an extraordinary update of the mentee overview module in the mentor dashboard. You can only schedule one update per two hours for performance reasons.

growthsetmenteestatus

Set mentee's status (allows mentees to enable/disable mentorship module, or to opt-out entirely, which deletes the mentee/mentor relationship)

growthsetmentor

Set user's mentor. Change will be publicly logged.

growthstarmentee

Mark or unmark a mentee as starred by current user (stored privately and not logged)

help

Display help for the specified modules.

homepagequestionstore

Obtain formatted questions posted via homepage modules

imagerotate

Esti módulu deshabilitóse.

import

Import a page from another wiki, or from an XML file.

jsonconfig

Permite l'accesu direutu al subsistema JsonConfig.

languagesearch

Buscar nomes de llingua en cualquier alfabetu.

linkaccount

Link an account from a third-party provider to the current user.

login

Log in and get authentication cookies.

logout

Log out and clear session data.

managetags

Perform management tasks relating to change tags.

massmessage

Unviar un mensaxe a una llista de páxines.

mergehistory

Merge page histories.

move

Move a page.

opensearch

Search the wiki using the OpenSearch protocol.

options

Change preferences of the current user.

paraminfo

Obtain information about API modules.

parse

Parses content and returns parser output.

patrol

Patrol a page or revision.

protect

Change the protection level of a page.

purge

Purge the cache for the given titles.

query

Fetch data from and about MediaWiki.

removeauthenticationdata

Remove authentication data for the current user.

resetpassword

Send a password reset email to a user.

revisiondelete

Delete and undelete revisions.

rollback

Undo the last edit to the page.

rsd

Export an RSD (Really Simple Discovery) schema.

setglobalaccountstatus

Definir l'estáu d'un usuariu global.

setnotificationtimestamp

Update the notification timestamp for watched pages.

setpagelanguage

Change the language of a page.

shortenurl

Acurtiar una URL llarga a una más curtia.

sitematrix

Obtener la llista de sitios de Wikimedia.

spamblacklist

Validate one or more URLs against the spam block list.

streamconfigs

Exposes event stream config. Returns only format=json with formatversion=2.

strikevote

Permite a los alministradores anular o restaurar un votu.

sxdelete

Delete the draft section translation and its parallel corpora from database.

tag

Add or remove change tags from individual revisions or log entries.

templatedata

Traer los datos almacenaos pola estensión TemplateData.

thank

Unviar una notificación d'agradecimientu a un editor.

titleblacklist

Validar un títulu de páxina, o nome de ficheru o d'usuariu escontra la llista prieta de títulos.

torblock

Check if an IP address is blocked as a Tor exit node.

transcodereset

Los usuarios col permisu 'transcode-reset' pueden reaniciar y volver a executar un trabayu transcode.

unblock

Unblock a user.

undelete

Undelete revisions of a deleted page.

unlinkaccount

Remove a linked third-party account from the current user.

upload

Upload a file, or get the status of pending uploads.

userrights

Change a user's group membership.

validatepassword

Validate a password against the wiki's password policies.

watch

Add or remove pages from the current user's watchlist.

webapp-manifest

Devuelve un manifest de webapp.

webauthn

API Module to communicate between server and client during registration/authentication process.

bouncehandler

Internal. Recibir un corréu electrónicu de rebote y procesalu pa xestionar el receptor fallíu.

categorytree

Internal. Módulu internu pa la estensión CategoryTree.

chartinfo

Internal. Retrieve current count of how many unique Chart page usages there are. Multiple uses of the same chart on the same page are considered a single use.

cirrus-check-sanity

Internal. Reports on the correctness of a range of page ids in the search index

cirrus-config-dump

Internal. Volcáu de la configuración de CirrusSearch.

cirrus-profiles-dump

Internal. Volcáu de los perfiles de CirrusSearch pa esta wiki.

cirrus-schema-dump

Internal. Dump of CirrusSearch schema (settings and mappings) for this wiki.

codemirror-validate

Internal. Check for validation errors in the given content

collection

Internal. API module for performing various operations on a wiki user's collection.

cspreport

Internal. Used by browsers to report violations of the Content Security Policy. This module should never be used, except when used automatically by a CSP compliant web browser.

cxcheckunreviewed

Internal. Check if any fast, unreviewed translation has been published recently for the current user.

cxfavoritesuggestions

Internal. Add or remove a favorite suggestion to the current user's list.

cxpublish

Internal. Guardar una paxina creada cola estensión Content Translation.

cxpublishsection

Internal. Save a section created using the Content Translation extension's section translation feature.

cxsave

Internal. Esti módulu permite guardar borradores de traducciones por sección p'aforrar anchor de banda y pa collechar córpora paralelos.

cxsplit

Internal. Create and save a section translation to database, for every translated section of the given article translation

discussiontoolscompare

Internal. Get information about comment changes between two page revisions.

discussiontoolspageinfo

Internal. Returns metadata required to initialize the discussion tools.

discussiontoolspreview

Internal. Preview a message on a discussion page.

echopushsubscriptions

Internal. Manage push subscriptions for the current user.

editcheckreferenceurl

Internal. Check the status of a URL for use as a reference.

fancycaptchareload

Internal. Solicitar un FancyCaptcha nuevu.

growthinvalidateimagerecommendation

Internal. Invalidate an image recommendation.

growthinvalidatepersonalizedpraisesuggestion

Internal. Invalidates a suggestion of a praiseworthy mentee in the Personalized praise module on the Mentor dashboard

growthinvalidaterevisetonerecommendation

Internal. Drop a 'Revise Tone' recommendation for a given page.

helppanelquestionposter

Internal. Handle questions posted via the help panel for the current user.

jsondata

Internal. Recuperar datos JSON llocalizaos.

jsontransform

Internal. Retrieve JSON data transformed by a Lua function.

parser-migration

Internal. Analizar una páxina con dos configuraciones de tidy distintes.

readinglists

Internal. Reading list write operations.

sanitize-mapdata

Internal. Fai la convalidación de datos pa la estensión Kartographer

scribunto-console

Internal. Módulu internu pa dar serviciu a les solicitúes XHR de la consola de Scribunto.

securepollauth

Internal. Allows a remote wiki to authenticate users before granting access to vote in the election.

stashedit

Internal. Prepare an edit in shared cache.

sxsave

Internal. Save the draft section translation and store the parallel corpora

timedtext

Internal. Provides timed text content for usage by <track> elements

ulslocalization

Internal. Obtener la llocalización de ULS na llingua dada.

ulssetlang

Internal. Update user's preferred interface language.

visualeditor

Internal. Devuelve HTML5 pa una páxina dende'l serviciu Parsoid.

visualeditoredit

Internal. Guardar una páxina HTML5 en MediaWiki (convertida en testu wiki mediante'l serviciu Parsoid).

wikimediaeventsblockededit

Internal. Log information about blocked edit attempts

wikimediaeventshcaptchaeditattempt

Internal. Log edit diff when hCaptcha challenge is shown but edit is incomplete

El formatu de la salida.

json

Output data in JSON format.

jsonfm

Output data in JSON format (pretty-print in HTML).

none

Output nothing.

rawfm

Output data, including debugging elements, in JSON format (pretty-print in HTML).

xml

Output data in XML format.

xmlfm

Output data in XML format (pretty-print in HTML).

El retrasu (lag) máximu puede utilizase cuando MediaWiki ta instaláu nun conxuntu de bases de datos replicaes. Pa evitar les aiciones que pudieran causar un retrasu entá mayor na replicación del sitiu, esti parámetru puede causar que'l cliente espere hasta que'l retrasu de replicación sía menor que'l valor especificáu. En casu de retrasu escesivu, devuélvese un códigu d'error maxlag con un mensaxe asemeyáu a Esperando a $host: $lag segundos de retrasu.
Ver Manual:Parámetru maxlag pa más información.

Establez l'encabezáu HTTP s-maxage de control de caché a esta cantidá de segundos. Los errores nunca se guarden na caché.

Establez l'encabezáu HTTP max-age de control de caché a esta cantidá de segundos. Los errores nunca se guarden na caché.

Comprobar que l'usuariu tien sesión aniciada si'l valor ye user, que nun la tien si ye anon, o que tien permisu de bot si ye bot.

Comprobar que'l usuariu actual ye l'usuariu nomáu.

Cualquier valor dau equí va incluyise na respuesta. Puede utilizase pa estremar solicitúes.

Incluyir el nome del host que sirvió la solicitú nes resultancies.

Incluyir la marca de tiempu actual na resultancia.

Incluye les llingües utilizaes pa uselang y errorlang nel resultáu.

Cuando s'accede a la API usando una solicitú AJAX dende otru dominiu (CORS), establezse esti valor al dominiu d'orixe. Tien d'incluíse en cualquier solicitú pre-vuelu, y polo tanto ten de ser parte de la URI de la solicitú (non del cuerpu POST).

Nes solicitúes con autenticación, tien de coincidir exautamente con unu de los orixes de la cabecera Origin, polo que tendría de ser daqué como https://en.wikipedia.org o https://meta.wikimedia.org. Si esti parámetru nun coincide cola cabecera Origin, va devolvese una respuesta 403. Si esti parámetru coincide cola cabecera Origin y l'orixe ta na llista blanca, van crease les cabeceres Access-Control-Allow-Origin y Access-Control-Allow-Credentials.

Nes solicitúes ensin autenticación, introduz el valor *. Esto va crear una cabecera Access-Control-Allow-Origin, pero'l valor de Access-Control-Allow-Credentials va ser false y tolos datos que dependan del usuariu tarán torgaos.

When accessing the API using a cross-domain AJAX request (CORS) and using a session provider that is safe against cross-site request forgery (CSRF) attacks (such as OAuth), use this instead of origin=* to make the request authenticated (i.e., not logged out). This must be included in any pre-flight request, and therefore must be part of the request URL (not the POST body).

Note that most session providers, including standard cookie-based sessions, do not support authenticated CORS and cannot be used with this parameter.

La llingua que va utilizase pa les traducciones de mensaxes. action=query&meta=siteinfo con siprop=languages devuelve una llista de códigos de llingua, o puedes introducir user pa usar la preferencia d'idioma del usuariu actual, o content pa usar l'idioma del conteníu d'esta wiki.

Variant of the language. Only works if the base language supports variant conversion.

Formatu utilizáu pa la salida del testu d'avisos y errores.

plaintext

Testu Wiki coles etiquetes HTML desaniciaes y les entidaes reemplazaes.

wikitext

Testu Wiki ensin analizar.

html

HTML.

raw

Clave y parámetros del mensaxe.

none

Nenguna salida de testu, solo los códigos d'error.

bc

Formatu emplegáu en versiones de MediaWiki anteriores a la 1.29.

Nun se tienen en cuenta errorlang y errorsuselocal.

plaintext

Wikitext with HTML tags removed and entities replaced.

wikitext

Unparsed wikitext.

html

HTML

raw

Message key and parameters.

none

No text output, only the error codes.

bc

Format used prior to MediaWiki 1.29. errorlang and errorsuselocal are ignored.

Idioma emplegáu p'avisos y errores. action=query&meta=siteinfo con siprop=languages devuelve una llista de códigos d'idioma, o especifica content pa utilizar la llingua del conteníu d'esta wiki o uselang pa utilizar el mesmu valor del parámetru uselang.

Si se da, los testos d'error emplegarán los mensaxes personalizaos llocalmente del espaciu de nomes MediaWiki.

Al tener accesu a la API usando una solicitú AJAX ente dominios (CORS), usa esto pa identificate como l'usuariu SUL actual. Usa action=centralauthtoken nesta wiki pa recibir el pase, antes de facer la solicitú CORS. Cada pase sólo puede usase una vegada, y espira después de 10 segundos. Esto tendría d'incluise'n toa solicitú pre-vuelu, y poro tendría d'incluise na URI de la solicitú (non nel cuerpu POST).

On this wiki the expected value is a JSON Web Token, which may be validated by proxy servers in front of MediaWiki. If the token has expired or is otherwise invalid, you may receive a HTTP error from a proxy in a different format than a normal API error.