@retroachievements/api
Version:
A well-tested library that lets you get achievement, user, and game data from RetroAchievements.
47 lines (46 loc) • 1.35 kB
TypeScript
import type { AuthObject } from "../utils/public";
import type { UsersFollowingMe } from "./models";
/**
* A call to this function will retrieve the list of users that are
* following the caller.
*
* @param authorization An object containing your username and webApiKey.
* This can be constructed with `buildAuthorization()`.
*
* @param payload.offset The number of entries to skip. The API will default
* to 0 if the parameter is not specified.
*
* @param payload.count The number of entries to return. The API will
* default to 100 if the parameter is not specified. The max number
* of entries that can be returned is 500.
*
* @example
* ```
* const usersFollowingMe = await getUsersFollowingMe(authorization);
* ```
*
* @returns An object containing a list of users that are following
* the caller.
* ```json
* {
* "count": 1,
* "total": 1,
* "results": [
* {
* "user": "Example",
* "ulid": "0123456789ABCDEFGHIJKLMNO",
* "points": 9001,
* "pointsSoftcore": 101,
* "amIFollowing": true
* }
* ]
* }
* ```
*
* @throws If the API was given invalid parameters (422) or if the
* API is currently down (503).
*/
export declare const getUsersFollowingMe: (authorization: AuthObject, payload?: {
offset?: number;
count?: number;
}) => Promise<UsersFollowingMe>;