Cette page fait partie de la documentation de l'API MediaWiki Action.

Il existe plusieurs façons de limiter l’utilisation de (certaines parties de) l’API à certains groupes d’utilisateurs ou de la désactiver complètement. Certaines d'entre elles nécessitent de modifer les permissions du groupe.

Disabling general access

There is no dedicated user permission for accessing the API. To disable API access for a specific user group, you can disable read permissions for that group. For instance, to disallow anonymous requests,

$wgGroupPermissions['*']['read'] = false;

Note that some API modules may be available regardless. If access is successfully prevented, the API output will usually show the error code 'readapidenied'.

Désactiver les modules

Vous pouvez désactiver les modules individuels pour tous les utilisateurs en ajoutant une ligne à LocalSettings.php. Ce que vous ajoutez dépend exactement du type de module que vous voulez désactiver :

• Pour les modules action=, utilisez $wgAPIModules ['modulename'] = 'ApiDisabled';
• Pour les modules prop=, utilisez $wgAPIPropModules ['modulename'] = 'ApiQueryDisabled';
• Pour les modules list=, utilisez $wgAPIListModules ['modulename'] = 'ApiQueryDisabled';
• Pour les modules meta=, utilisez $wgAPIMetaModules ['modulename'] = 'ApiQueryDisabled';

$wgAPIModules['edit'] = 'ApiDisabled';

static function onApiCheckCanExecute( $module, $user, &$message ) {
    $moduleName = $module->getModuleName();
    if (
        $moduleName == 'action' &&
        !in_array( 'right', $user->getRights() )
    ) {
        $message = 'apierror-action-notallowed';
        return false;
    }
    return true;
}