com.github.scribejava.apis.MediaWikiApi Maven / Gradle / Ivy

package com.github.scribejava.apis;

import com.github.scribejava.core.builder.api.DefaultApi10a;

public class MediaWikiApi extends DefaultApi10a {

    private static class InstanceHolder {

        private static final MediaWikiApi INSTANCE = new MediaWikiApi(
                "https://meta.wikimedia.org/w/index.php",
                "https://meta.wikimedia.org/wiki/"
        );
    }

    private static class BetaInstanceHolder {

        private static final MediaWikiApi BETA_INSTANCE = new MediaWikiApi(
                "https://meta.wikimedia.beta.wmflabs.org/w/index.php",
                "https://meta.wikimedia.beta.wmflabs.org/wiki/"
        );
    }

    private final String indexUrl;
    private final String niceUrlBase;

    /**
     * @param indexUrl The URL to the index.php of the wiki. Due to a
     * MediaWiki bug, some requests must currently use the non-nice URL.
     * @param niceUrlBase The base of nice URLs for the wiki, including the trailing slash. Due to
     * another MediaWiki bug, some requests must currently use
     * the nice URL.
     */
    public MediaWikiApi(String indexUrl, String niceUrlBase) {
        this.indexUrl = indexUrl;
        this.niceUrlBase = niceUrlBase;
    }

    /**
     * The instance for wikis hosted by the Wikimedia Foundation.Consumers are requested on
     * 
     * Special:OAuthConsumerRegistration/propose
     * .
     *
     * @return instance
     */
    public static MediaWikiApi instance() {
        return InstanceHolder.INSTANCE;
    }

    /**
     * The instance for wikis in the Wikimedia Foundation’s Beta Cluster. Consumers are requested on
     * 
     * Special:OAuthConsumerRegistration/propose
     * .
     *
     * @return instanceBeta
     */
    public static MediaWikiApi instanceBeta() {
        return BetaInstanceHolder.BETA_INSTANCE;
    }

    @Override
    public String getRequestTokenEndpoint() {
        return indexUrl + "?title=Special:OAuth/initiate";
    }

    @Override
    public String getAuthorizationBaseUrl() {
        return niceUrlBase + "Special:OAuth/authorize";
    }

    @Override
    public String getAccessTokenEndpoint() {
        return indexUrl + "?title=Special:OAuth/token";
    }

}