Interface
Base options interface for making authenticated requests for groups.
Properties
| Property | Type | Notes |
|---|---|---|
authenticationinherited | IAuthenticationManager | The instance of |
clientId | string | ClientId of the application through which user receives messages on the mobile device. This only applies to push notifications. |
credentialsinherited | RequestCredentials | A string indicating whether credentials (cookies) will be sent with the request. Used internally for authentication workflows. |
headersinherited | {} | Additional Headers to pass into the request. |
hideTokeninherited | boolean | Prevents the token from being passed in a URL Query param that is saved in browser history. Instead, the token will be passed in POST request body or through X-Esri-Authorization header. NOTE: This will force POST requests in browsers since auth header is not yet supported by preflight OPTIONS check with CORS. |
httpMethodinherited | HTTPMethods | The HTTP method to send the request with. |
idinherited | string | Unique identifier of the group. |
maxUrlLengthinherited | number | If the length of a GET request's URL exceeds |
message | string | object | Message to be sent. For builtin and email notifications this is a string. For push notifications, this will be JSON. |
notificationChannelType | NotificationChannelType | The channel through which the notification is to be delivered. Supported values are push, email, or builtin. If push is chosen, a message will be delivered only to those group members that have registered their devices to receive push notifications. If the user has registered more than one device for the app, then message will be sent to all the registered devices. Email will be sent when the email option is chosen. If the builtin option is chosen, a notification will be added to the notifications list that the user can see when logged into the home app. |
paramsinherited | IParams | Additional parameters to pass in the request. |
portalinherited | string | Base url for the portal you want to make the request to. Defaults to authentication.portal if authentication exists, otherwise to 'https://www.arcgis.com/sharing/rest'. |
rawResponseinherited | boolean | Return the raw response |
requestinherited | (url: string, requestOptions: InternalRequestOptions) => Promise<any> | Override the default function for making the request. This is mainly useful for testing purposes (i.e. so you can pass in a spy). |
signalinherited | AbortSignal | An AbortSignal object instance; allows you to abort a request and via an AbortController. |
silentNotification | boolean | This only applies to push notifications. When set to true, message will be delivered to the app and it will not show as an alert to the user. |
subject | string | Subject of the notification. This only applies to email and builtin notifications. For push notifications, subject/title is provided as a part of the message payload. |
suppressWarningsinherited | boolean | Suppress any ArcGIS REST JS related warnings for this request. |
users | string[] | Array of usernames of the users in the group to whom the message should be sent. If not provided, the message will be sent to all users in the group if the user is an admin. Only group admins will be able to send notifications to a list of users. Group users will be able to send notifications to only one user at a time. |
authentication
authentication: IAuthenticationManagerThe instance of @esri/arcgis-rest-request!ArcGISIdentityManager , @esri/arcgis-rest-request!ApplicationCredentialsManager or @esri/arcgis-rest-request!ApiKeyManager to use to authenticate this request. A token may also be passed directly as a string however using the built in authentication managers is encouraged.
clientId
clientId: stringClientId of the application through which user receives messages on the mobile device. This only applies to push notifications.
credentials
credentials: RequestCredentialsA string indicating whether credentials (cookies) will be sent with the request. Used internally for authentication workflows.
headers
headers: {}Additional Headers to pass into the request.
Type declaration
hideToken
hideToken: booleanPrevents the token from being passed in a URL Query param that is saved in browser history. Instead, the token will be passed in POST request body or through X-Esri-Authorization header. NOTE: This will force POST requests in browsers since auth header is not yet supported by preflight OPTIONS check with CORS.
httpMethod
httpMethod: HTTPMethodsThe HTTP method to send the request with.
maxUrlLength
maxUrlLength: numberIf the length of a GET request's URL exceeds maxUrlLength the request will use POST instead.
message
Interface Propertymessage: string | objectMessage to be sent. For builtin and email notifications this is a string. For push notifications, this will be JSON.
notificationChannelType
notificationChannelType: NotificationChannelTypeThe channel through which the notification is to be delivered. Supported values are push, email, or builtin. If push is chosen, a message will be delivered only to those group members that have registered their devices to receive push notifications. If the user has registered more than one device for the app, then message will be sent to all the registered devices. Email will be sent when the email option is chosen. If the builtin option is chosen, a notification will be added to the notifications list that the user can see when logged into the home app.
portal
portal: stringBase url for the portal you want to make the request to. Defaults to authentication.portal if authentication exists, otherwise to 'https://www.arcgis.com/sharing/rest'.
request
request: (url: string, requestOptions: InternalRequestOptions) => Promise<any>Override the default function for making the request. This is mainly useful for testing purposes (i.e. so you can pass in a spy).
Type declaration
function(url: string, requestOptions: InternalRequestOptions): Promise<any>Parameters
| Parameter | Type |
|---|---|
url | string |
request | InternalRequestOptions |
Returns
Promise<any>signal
signal: AbortSignalAn AbortSignal object instance; allows you to abort a request and via an AbortController.
silentNotification
silentNotification: booleanThis only applies to push notifications. When set to true, message will be delivered to the app and it will not show as an alert to the user.
subject
subject: stringSubject of the notification. This only applies to email and builtin notifications. For push notifications, subject/title is provided as a part of the message payload.
suppressWarnings
suppressWarnings: booleanSuppress any ArcGIS REST JS related warnings for this request.
users
users: string[]Array of usernames of the users in the group to whom the message should be sent. If not provided, the message will be sent to all users in the group if the user is an admin. Only group admins will be able to send notifications to a list of users. Group users will be able to send notifications to only one user at a time.