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 blocks Copy
1
2
3
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
.
Inheritance: ApiKeyManager AuthenticationManagerBase
Constructors Properties Property Type Notes portal
string
The current portal the user is authenticated with.
portal Class Propertyportal: string = "https://www.arcgis.com/sharing/rest"
The current portal the user is authenticated with.
Accessors Accessor Returns Notes get token()
string
Gets the current access token (the API Key).
get username()
string
The username of the currently authenticated user.
token Class Accessorget token(): string
Gets the current access token (the API Key).
ReturnsÂstring
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 the current access 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.
serialize()
string
Serializes the ApiKeyManager instance to a JSON string.
toJSON()
{ portal: string; token: string; type: string; username: string }
Converts the ApiKeyManager
instance to a JSON object. This is called when the instance is serialized to JSON with JSON.stringify()
.
deserialize(serialized)
ApiKeyManager
Deserializes a JSON string previously created with ApiKeyManager.deserialize
to an ApiKeyManager
instance.
fromKey(apiKey)
ApiKeyManager
The preferred method for creating an instance of ApiKeyManager
.
inherited
Class MethodclearCachedUserInfo(): void
Clear the cached user infornation. Usefull to ensure that the most recent user information from AuthenticationManagerBase.getUser
is used.
void
Inherited from AuthenticationManagerBase.clearCachedUserInfo
getToken Class MethodgetToken(url:Â string): Promise<string>
Gets the current access token (the API Key).
Parameters Parameter Typeurl
string Returns Promise<string>
getUser
inherited
Class MethodgetUser(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 blocks Copy
1
2
3
4
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.
Promise<IUser>
A Promise that will resolve with the data from the response.
Inherited from AuthenticationManagerBase.getUser
getUsernameinherited
Class MethodgetUsername(): 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 blocks Copy
1
2
3
4
manager.getUsername()
.then(response => {
console.log(response); // "casey_jones"
})
Returns Promise<string>
Inherited from AuthenticationManagerBase.getUsername
serialize Class Methodserialize(): string
Serializes the ApiKeyManager instance to a JSON string.
Use dark colors for code blocks Copy
1
2
3
4
5
import { ApiKeyManager } from '@esri/arcgis-rest-request';
const apiKey = new ApiKeyManager.fromKey("...")
localStorage.setItem("apiKey", apiKey.serialize());
Returns string
The serialized JSON string.
toJSON Class MethodtoJSON(): { portal: string; token: string; type: string; username: string }
Converts the ApiKeyManager
instance to a JSON object. This is called when the instance is serialized to JSON with JSON.stringify()
.
Use dark colors for code blocks Copy
1
2
3
4
5
import { ApiKeyManager } from '@esri/arcgis-rest-request';
const apiKey = new ApiKeyManager.fromKey("...")
const json = JSON.stringify(session);
Returns { portal: string; token: string; type: string; username: string }
A plain object representation of the instance.
static
Class Methoddeserialize(serialized:Â string): ApiKeyManager
Deserializes a JSON string previously created with ApiKeyManager.deserialize
to an ApiKeyManager
instance.
Use dark colors for code blocks Copy
1
2
3
import { ApiKeyManager } from '@esri/arcgis-rest-request';
const apiKey = ApiKeyManager.deserialize(localStorage.getItem("apiKey"));
Parameters Parameter Type Notes serialized
string
The serialized JSON string.
ReturnsÂApiKeyManager
The deserialized ApiKeyManager instance.
fromKeystatic
Class MethodfromKey(apiKey: string | IApiKeyOptions): ApiKeyManager
The preferred method for creating an instance of ApiKeyManager
.
ApiKeyManager
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4