API:Cross-site requests/ru

Если пользовательскому скрипту или гаджету нужно сделать вызов API другого сайта на движке MediaWiki (например, скрипту на русской Википедии нужно проверить информацию изображения на Викискладе), необходимо использовать JSONP или CORS.

Использование JSONP
API  принимает параметр «callback», который указывает название функции JavaScript, в которую будет обёрнут результат JSON. Это может быть использовано, чтобы вызвать API на другом сайте, динамически добавляя теги к документу.

Обратите внимание, что все запросы JSONP будут обработаны, как если бы вход в учётную запись произведён не был, даже если браузер аутентифицирован на другой вики.

Использование CORS
API MediaWiki также требует, чтобы исходный сайт был указан как параметр строки запроса, называющийся, который проверяется на соответствие с требуемым протоколом CORS заголовком Origin. Обратите внимание, что этот заголовок должен быть включён в любой pre-flight запрос, и таким образом должен быть включён в часть строки запроса запрашиваемого URI даже для POST запросов.

Чтобы другая вики разрешала CORS-запросы,  должен быть установлен соответствующе, чтобы разрешить исходный сайт. Если проверка источника CORS проходит, MediaWiki включит заголовок  в ответ, чтобы куки аутентификации могли быть посланы.

Неаутентифицируемые CORS-запросы могут быть посланы с любого источника, если параметр «origin» запроса задать как равный «*». В этом случае MediaWiki включит в ответ заголовок  и обработает запрос как посланный не зашедшим в учётную запись пользователем (на случай если входные данные каким-то образом всё равно были отправлены).

Если указан параметр запроса «origin», MediaWiki (с версии 1.30) вернёт заголовок  с кратким описанием причины ошибки, если запрос не приводит к успешному CORS-ответу, например в случае несовпадения источников или неподдерживаемых заголовков в заголовке запроса.

См. Manual: CORS для инструкций о том, как обрабатывать CORS-запросы через JavaScript.