API:Cross-site requests/es

Si un script de usuario o un accesorio necesita hacer una llamada de la API contra otro sitio de MediaWiki (por ejemplo, un script en Wikipedia en español tiene que comprobar información de imágenes de Commons), tiene que usar JSONP o CORS.



Uso de JSONP
El API $Json acepta un parámetro de, cuyo valor es una función de JavaScript en la que el JSON resultado será incluido. Esto se puede usar para llamar a la API en un sitio remoto añadiendo etiquetas al documento.

Ejemplo


CONSIGUE petición


Respuesta


Uso de CORS
El API de MediaWiki requiere que el  sea suministrado como parámetro de cadena de consulta, siendo el valor el sitio desde el que se origina la solicitud, que coincide con el encabezado Origen requerido por el protocolo CORS. Ten en cuenta que el parámetro debe incluirse en cualquier petición de preverificación, y por tanto debe incluirse en la parte de la cadena de consulta de la URI de la petición, incluso para peticiones POST.

Cuando el parámetro  es proporcionado y la petición no devuelve una respuesta CORS exitosa, MediaWiki≥1.30 devolverá un $encabezado de rechazo con una breve razón del error, p. Ej. en caso de origen no coincidente o encabezados no compatibles en un encabezado de petición $reqheaders.



Peticiones CORS no autentificadas
Las peticiones CORS no autenticadas pueden ser realizadas desde cualquier origen estableciendo el parámetro de petición  en. En este caso, MediaWiki incluirá el encabezamiento  en la respuesta y procesará la petición como si hubiera cerrado la sesión.

Ejemplo


CONSIGUE petición


Respuesta


Peticiones CORS autenticadas
Para hacer una petición CORS autentificada, la variable  del wiki remoto debe estar configurada de tal forma que admita el sitio de origen. Si el origen del CORS es aceptado, MediaWiki incluirá la cabecera  en la respuesta para que se puedan enviar cookies de autentificación.

Véase para las instrucciones para manejar peticiones CORS en JavaScript.



Notas adicionales

 * Las diferencias detalladas entre JSONP y CORS están disponibles en CORS vs JSONP.

