ClientsApi: Clients operations

In deardooley/agave-rlang-sdk: Agave Platform client SDK for R

Description

rAgave.Clients

Usage

ClientsApi

Format

An object of class R6ClassGenerator of length 24.

Details

The Clients API is the client registration service for the Agave Platform. This service is in charge of issuing and managing API keys for your client applications as well as its subscriptions to boutique APIs availabled from within your tenant.

api <- Agave$new(username="username", password="password")

myClient <- api$clients$create(body=list(clientName = "my_client"))

api <- Agave$new(username="username", password="password")#'

Fields

path

Stores url path of the request.

apiClient

Handles the client-server communication.

userAgent

Set the user agent of the request.

Methods

$create(body, updateCache) Creates a new client. Client names must be unique within a tenant. Attempting to create a client with an existing name will fail notifying you of the name conflict. If you already own a client with the given name, but have lost the key, you may delete the existing client and create a new one with the same name. Setting updateCache to FALSE will prevent the client key and secret from being written to your local auth cache. The default is TRUE.

Usage

myClient <- Client$new(clientName="my_client")
clients$create(body=myClient)

myImplicitClient <- Client$new(clientName="my_client", description="My cool app", callbackUrl="https://example.com/oauth2", tier="UNLIMITED")
clients$create(body=myImplicitClient)

$addSubscription(clientName, body) Subscribe to an API. You must have been granted access to the API by the author before you can subscribe. Every new client is subsribed to all the core science API by default.

Usage

subscriptionRequest <- ClientSubscriptionRequest(apiName="Tags", apiProvider="admin", apiVersion="v2", tier="UNLIMITED")
clients$addSubscription(clientName="my_client", body=subscriptionRequest)

$clearSubscriptions(clientName) Unsubscribe the client from all API to which it is currently subscribed.

Usage

clients$clearSubscriptions(clientName="my_client")

$delete(clientName) Delete the given client. This will invalidate the client's keys and any outstanding, active tokens it has.

Usage

clients$delete(clientName="my_client")

$getDetails(clientName) Fetch the client details. Note that the client secret will not be returned once the client is created.

Usage

clients$getDetails(clientName="my_client")

$listSubscriptions(clientName) List all API to which the client is subscribed.

Usage

clients$listSubscriptions(clientName="my_client")

$list() list all clients for the autehnticated user

Usage

clients$list()

deardooley/agave-rlang-sdk documentation built on May 17, 2019, 10:12 p.m.