API:Edit/es

From MediaWiki.org
Jump to navigation Jump to search
Otros idiomas: English  • Deutsch • español • français • 日本語 • русский • Tiếng Việt • 中文
Versión de MediaWiki: 1.13

Token[edit]

Para editar una página se necesita un edit token. Éste es igual para todas las páginas, pero cambia cada vez que se inicia sesión. Si quieres protegerte contra los conflictos de edición (algo muy sabio), también debes obtener el timestamp de la última versión. Puedes obtenerlos de la siguiente forma: Obtener el edit token

Editando páginas[edit]

Las páginas pueden crearse y editarse con action=edit.

Parámetros[edit]

  • title: Página a editar.
  • section: Sección a editar. Use 0 para la sección principal, o 'new' para crear una nueva sección.
  • text: El contenido de la página o sección.
  • token: Edit token.
  • summary: Resumen de edición.
    • Cuando se usa section=new, este parámetro se emplea para el título de la sección.
  • minor: Si se habilita, marca la edición como menor.
  • notminor: Si se habilita, no marca la edición como menor, incluso si habilitó la preferencia "Marcar todas mis ediciones como menores, por defecto".
  • bot: Si se habilita, marca la edición como bot.
  • basetimestamp: Timestamp de la última contribución, usado para detectar conflictos de edición. Si no se especifica se ignoran.
  • recreate: Si se habilita, ignora el error producido cuando la página ya había sido borrada y se está creando.
  • createonly: Si se habilita, produce un error si la página ya existe.
  • watch: Agrega la página a la lista de seguimiento.
  • unwatch: Remueve la página de la lista de seguimiento, o no la agrega si se habilita la opción del estilo "Automáticamente vigilar todas las páginas que edito".
  • captchaid: CAPTCHA ID de la petición anterior.
  • captchaword: Respuesta al CAPTCHA

Ejemplo[edit]

Nota: En este ejemplo, todos los parámetros se pasan con el método GET sólo por simplicidad. De todas formas, action=edit necesita que se use el método POST; usar GET producirá un error. Agregar una nueva sección a en:Talk:Main Page

CAPTCHAs y errores de extensiones[edit]

Si una edición necesita un CAPTCHA, se obtendrá algo por el estilo:

<?xml version="1.0" encoding="utf-8"?>
<api>
  <edit result="Failure">
    <captcha type="math" mime="text/tex" id="509895952" question="36 + 4 = " />
  </edit>
</api>

En la mayoría de los casos, no obtendrás un CAPTCHA matemático, sino la dirección a una imagen (en el campo URL). Una vez que resuelva el CAPTCHA, reintente la petición (en este caso habría que agregar captchaid=509895952&captchaword=40).

Otras extensiones que usan APIEditBeforeSave pueden devolver errores usando el formato descrito anteriormente o en el formato usual de errores.

Posibles errores[edit]

Además de los usuales:

  • code: notitle
    • info: The title parameter must be set
    • significado: Debe indicarse el nombre de la página (parámetro title).
  • code: notext
    • info: The text parameter must be set
    • significado: Debe indicarse el contenido de la página (parámetro text).
  • code: notoken
    • info: The token parameter must be set
    • significado: Debe indicarse el edit token.
  • code: invalidsection
    • info: The section parameter must be set to an integer or 'new'
    • significado: El valor de section no es válido. Debe ser un número entero o 'new'.
  • code: protectedtitle
    • info: This title has been protected from creation
    • significado: Este título fue protegido contra creaciones.
  • code: cantcreate
    • info: You don't have permission to create new pages
    • significado: No tiene permiso para crear nuevas páginas.
  • code: cantcreate-anon
    • info: Anonymous users can't create new pages
    • significado: Los usuarios anónimos no pueden crear páginas nuevas.
  • code: articleexists
    • info: The article you tried to create has been created already
    • significado: El artículo que intenta crear ya existe.
  • code: noimageredirect-anon
    • info: Los usuarios anónimos no pueden crear redirecciones de imágenes.
  • code: noimageredirect
    • info: You don't have permission to create image redirects
    • significado: No tiene permiso para crear redirecciones de imágenes.
  • code: spamdetected
    • info: Your edit was refused because it contained a spam fragment: ``wikitext''
    • significado: La edición fue rechazada porque contiene el siguiente fragmento de spam:
  • code: filtered
    • info: The filter callback function refused your edit
    • significado: El filtro rechazó la edición.
  • code: contenttoobig
    • info: The content you supplied exceeds the article size limit of bytes bytes
    • significado: El contenido enviado excede el límite de tamaño de artículo de ... bytes.
  • code: noedit-anon
    • info: Anonymous users can't edit pages
    • significado: Los usuarios anónimos no pueden editar páginas.
  • code: noedit
    • info: You don't have permission to edit pages
    • significado: No tiene permiso para editar páginas.
  • code: pagedeleted
    • info: The page has been deleted since you fetched its timestamp
    • significado: La página fue eliminada.
  • code: emptypage
    • info: Creating new, empty pages is not allowed
    • significado: No se permite crear páginas nuevas que estén vacías.
  • code: editconflict
    • info: Edit conflict detected
    • significado: Se detectó un conflicto de edición.