Manual:Hooks/ApiCheckCanExecute
From mediawiki.org
| ApiCheckCanExecute | |
|---|---|
| Available from version 1.20.0 Called during ApiMain::checkCanExecute(). | |
| Define function: | public static function onApiCheckCanExecute( $module, $user, &$message ) { ... } |
| Attach hook: | In extension.json:
{ "Hooks":{ "ApiCheckCanExecute":"MediaWiki\\Extension\\MyExtension\\Hooks::onApiCheckCanExecute" } } |
| Called from: | File(s): api/ApiMain.php |
| Interface: | ApiCheckCanExecuteHook.php |
For more information about attaching hooks, see Manual:Hooks .
For examples of extensions using this hook, see Category:ApiCheckCanExecute extensions.
Details
[edit ]Called during ApiMain::checkCanExecute(). Use to further authenticate and authorize API clients before executing the module. Return false and set a message to cancel the request.
- $module: Module object
- $user: Current user
- &$message: API usage message to die with. Since 1.27, it is preferred to use an ApiMessage object here. A string or array is currently passed to
ApiBase::dieUsageMsg(), but this is planned to change in 1.29.