Methods

7 min

$pinc.oauth.authorized()

$pinc.oauth.authorizedList()

$pinc.oauth.processCommand()

$pinc.oauth.bind()

$pinc.oauth.client.connections()

$pinc.oauth.client.display()

$pinc.oauth.revoke()

authorized(provider, [userId], callback)

Allows you to query whether the user has previously authorized an Integration. User this interface when you wish to query the authorization status for a single provider.

arguments

Argument	Description
provider	Internal provider name. See Provider reference
user_Id	optional: Defaults to the data-user-id attribute in the script tag
callback	JavaScript callback.

Example



function checkAuthorized(){
		var provider = "googlemail";
		var userId = "[email protected]"
		$pinc.oauth.authorized(provider, userId, (authorized)=>{
			console.log(authorized);
		})
	}

authorizedList(userId, callback)

Gives you a list of providers that the user has authorized

Example


function checkAuthorized(){
		var userId = "[email protected]"
		//set the userId to null if you want it to default 
		$pinc.oauth.authorizedList(userId, (providerList)=>{
			//array providerList
			console.log (providerList)
		})
	}

processCommand(json_params)

Inititates the OAuth authorization process for the given provider. Ensure that this method is called synchronously on user interaction (onclick etc.). An asynchronous call to this function will block any authorizations that work with popups.

Param	Description
provider	Internal provider name. See Provider reference
user_id	optional: Defaults to the data-user-id attribute in the script tag

Example



function clickHandler(){
    /*optional
        user_id: if you want to override the data-user-id specified in the script tag
    */
    var commandParams = {
        "provider":"googlecalendar",
        "user_id":"..."
        };
    $pinc.oauth.processCommand(commandParams)
}

bind(div)

Pass the div element for scenarios where the div is dynamically added to the page using JavaScript of shadow DOM.



function lateRender(elDiv){
    /*
    ensure that the DOM element being passed has the folowing attributes
        <div 
            data-oauth-ui="list-columns/list/list-panel" 
            data-oauth-ui-switches="statusOn,disconnect" 
            data-oauth-icon-size="Medium/Large" 
            data-oauth-button-color="#007BFF" 
            data-oauth-ui-providers="googlecalendar,msgraphcalendar,..." 
            data-oauth-ui-providerTypes=""></div>
     */
    $pinc.oauth.bind(elDiv);
}

revoke(provider,userId)

Invokes the token revocation for the current user. If the provider does no offer API based revocation then the tokens are deleted from the Pathfix databases/caches.

Example



function revoke(){
    $pinc.events.on("$pinc.oauth","revoked",data=>{console.log(data)})
    $pinc.oauth.revoke("googlecalendar");
}

Provider reference