API:Cross-site requests/ru

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

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

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

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

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

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

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

Additional notes

 * Detailed differences between JSONP and CORS are available at CORS vs JSONP.