ApiKeyManager

Class

Used to authenticate methods in ArcGIS REST JS with an API keys. The instance of ApiKeyManager can be passed to IRequestOptions.authentication to authenticate requests.

Use dark colors for code blocksCopy
import { ApiKeyManager } from '@esri/arcgis-rest-request';

const apiKey = new ApiKeyManager.fromKey("...");

In most cases however the API key can be passed directly to the IRequestOptions.authentication.

Implements

IAuthenticationManager

Inheritance: ApiKeyManagerAuthenticationManagerBase

Constructors

constructor

Class Constructor

new ApiKeyManager(options: IApiKeyOptions): ApiKeyManager

Parameters

Parameter	Type
`options`	IApiKeyOptions

Returns

ApiKeyManager

Properties

Property	Type	Notes
`portal`	`string`	The current portal the user is authenticated with.

portal

Class Property

portal: string = "https://www.arcgis.com/sharing/rest"

The current portal the user is authenticated with.

Accessors

Accessor	Returns	Notes
`get username()`	`string`	The username of the currently authenticated user.

username

Class Accessor

get username(): string

The username of the currently authenticated user.

Returns

string

Methods

Hide inherited methods

Method	Returns	Notes
`clearCachedUserInfo()` inherited	`void`	Clear the cached user infornation. Usefull to ensure that the most recent user information from `AuthenticationManagerBase.getUser` is used.
`getToken(url)`	`Promise<string>`	Gets a token (the API Key).
`getUser(requestOptions?)` inherited	`Promise<IUser>`	Returns information about the currently logged in user. Subsequent calls will not result in additional web traffic.
`getUsername()` inherited	`Promise<string>`	Returns the username for the currently logged in user. Subsequent calls will not result in additional web traffic. This is also used internally when a username is required for some requests but is not present in the options.
`fromKey(apiKey)`	`ApiKeyManager`	The preferred method for creating an instance of `ApiKeyManager`.

clearCachedUserInfo

inherited

Class Method

clearCachedUserInfo(): void

Clear the cached user infornation. Usefull to ensure that the most recent user information from AuthenticationManagerBase.getUser is used.

Returns

void

Inherited from AuthenticationManagerBase.clearCachedUserInfo

getToken

Class Method

getToken(url: string): Promise<string>

Gets a token (the API Key).

Parameters

Parameter	Type
`url`	string

Returns

Promise<string>

getUser

inherited

Class Method

getUser(requestOptions?: IRequestOptions): Promise<IUser>

Returns information about the currently logged in user. Subsequent calls will not result in additional web traffic.

Use dark colors for code blocksCopy
manager.getUser()
  .then(response => {
    console.log(response.role); // "org_admin"
  })

Parameters

Parameter	Type	Notes
`requestOptions`	IRequestOptions	Options for the request. NOTE: `rawResponse` is not supported by this operation.

Returns

Promise<IUser>

A Promise that will resolve with the data from the response.

Inherited from AuthenticationManagerBase.getUser

getUsername

inherited

Class Method

getUsername(): Promise<string>

Returns the username for the currently logged in user. Subsequent calls will not result in additional web traffic. This is also used internally when a username is required for some requests but is not present in the options.

Use dark colors for code blocksCopy
manager.getUsername()
  .then(response => {
    console.log(response); // "casey_jones"
  })

Returns

Promise<string>

Inherited from AuthenticationManagerBase.getUsername

fromKey

static

Class Method

fromKey(apiKey: string | IApiKeyOptions): ApiKeyManager

The preferred method for creating an instance of ApiKeyManager.

Parameters

Parameter	Type
`apiKey`	string \| IApiKeyOptions

Returns

ApiKeyManager