Interface PlayerRequestOptions
interface PlayerRequestOptions {
allowCache?: boolean;
apiKey?: string;
cacheFor?: number;
forceCaseMatch?: boolean;
forceUUIDLookup?: boolean;
ignoreVersion?: boolean;
player: string;
priority?: boolean;
retries?: number;
timeout?: number;
}
allowCache?: boolean;
apiKey?: string;
cacheFor?: number;
forceCaseMatch?: boolean;
forceUUIDLookup?: boolean;
ignoreVersion?: boolean;
player: string;
priority?: boolean;
retries?: number;
timeout?: number;
}
Hierarchy
- RequestOptions
- PlayerRequestOptions
Properties
Optional allow
allow
Whether to allow this request to use the cache or ongoing requests if available
Requests using cache or other requests do not count towards the ratelimit and return a lot faster.
Optional api
api
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.
Optional cache
cache
The amount of time the request should be cached for, overwrites the defaults specified in the config
Optional force
force
Default
false
Optional forceUUIDLookup
forceUUIDLookup?: boolean
Whether to force a UUID lookup before the player request. This can help reduce some errors caused by name changes. Ignored if player is a UUID
This may cause extra API requests.
This makes the request case sensitive.
Default
false
Optional ignore
ignore
Whether to ignore version errors
You can use this to resolve temporary conflicts while the library awaits being updated. Otherwise it should stay enabled.
Default
false
player
player: string
A player UUID or name; case-insensitive
Optional priority
priority?: boolean
Whether this request should be put to the front of the queue, executing before any non-priority requests are handled
Default
false
Optional retries
retries?: number
The amount of times to retry the request on error
Optional timeout
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.
The options for a player API request