RawRequestOptions | gavel-gateway-js

The options for a raw API request

Index

allowCache?: boolean

Whether to allow this request to pull from cache if available

allowStacking?: boolean

Whether requests to the same route should be allowed to be stacked, see Config.allowStackingByDefault

Stacked requests only use a single API request and return the EXACT same object as all other requests in the stack.

Keeping this enabled can cause errors if requested data is mutated in downstream code

apiKey?: string

The API key to use in this request

The key has to be registered in the config.

If this is not given, the registered key with the most free requests will be selected.

cacheFor?: number

The amount of time the request should be cached for, overwrites the defaults specified in the config

ignoreVersion?: boolean

Whether to ignore version errors

You can use this to resolve temporary conflicts while the library awaits being updated. Otherwise it should stay enabled.

interpret?: boolean

Whether errors or profiles not being found should be filtered out and throw errors/return null

priority?: boolean

Whether this request should be put to the front of the queue, executing before any non-priority requests are handled

retries?: number

The amount of times to retry the request on error

The API route to request

routeVersion?: string | number

The expected version or request.version property, responses with another version will throw an error

timeout?: number

The amount of milliseconds a until the request should be rejected

Be aware that each retry has it's own timeout, meaning 30,000 ms of timeout may lead to a 90,000 ms wait until a request is rejected on 2 retries.