Yurba.js

Appearance

Class: UserResource ​

User Friends ​

friends() ​

GET /user/{user_tag}/friends API Docs

friends(page): Promise<UserModel[]>

Gets current user's friends

Parameters ​

page ​

number = 0

Page number (default 0)

Returns ​

Promise<UserModel[]>

Array of UserModel objects

Since ​

1.0.0

Throws ​

If user not found in cache

Example ​

javascript
const friends = await rest.users.friends();
const nextPage = await rest.users.friends(1);

getFriends() ​

GET /user/{user_tag}/friends API Docs

getFriends(user, page): Promise<UserModel[]>

Gets user friends

Parameters ​

user ​

User ({tag}/{id}/u{id})

string | number

page ​

number

Page number

Returns ​

Promise<UserModel[]>

Array of UserModel objects

Since ​

1.0.0

Throws ​

If parameters are invalid

Example ​

javascript
const friends = await rest.users.getFriends('username', 0);
const friendsById = await rest.users.getFriends(12345, 1);

getRelationships() ​

GET /user/{user_tag}/relationships API Docs

getRelationships(user): Promise<RelationshipsResult>

Gets user relationships

Parameters ​

user ​

User ({tag}/{id}/u{id})

string | number

Returns ​

Promise<RelationshipsResult>

Relationships data

Since ​

1.0.0

Throws ​

If user identifier is invalid

Example ​

javascript
const relationships = await rest.users.getRelationships('username');

ignoreIncomingRequest() ​

DELETE /incoming_requests/{user_id} API Docs

ignoreIncomingRequest(userId): Promise<BaseOkay>

Ignores incoming friend request

Parameters ​

userId ​

number

User identifier

Returns ​

Promise<BaseOkay>

Operation result

Since ​

1.0.0

Throws ​

If user ID is invalid

Example ​

javascript
await rest.users.ignoreIncomingRequest(12345);

incomingRequests() ​

GET /incoming_requests API Docs

incomingRequests(page): Promise<UserModel[]>

Gets incoming friend requests

Parameters ​

page ​

number = 0

Page number

Returns ​

Promise<UserModel[]>

Array of UserModel objects

Since ​

1.0.0

Throws ​

If page number is invalid

Example ​

javascript
const requests = await rest.users.incomingRequests();
const nextPage = await rest.users.incomingRequests(1);

outgoingRequests() ​

GET /outcoming_requests API Docs

outgoingRequests(page): Promise<UserModel[]>

Gets outgoing friend requests

Parameters ​

page ​

number = 0

Page number

Returns ​

Promise<UserModel[]>

Array of UserModel objects

Since ​

1.0.0

Throws ​

If page number is invalid

Example ​

javascript
const requests = await rest.users.outgoingRequests();
const nextPage = await rest.users.outgoingRequests(1);

subscribe() ​

PATCH /user/{user_tag}/subscribe API Docs

subscribe(user): Promise<RelationshipsResult>

Subscribe to user

Parameters ​

user ​

User ({tag}/{id}/u{id})

string | number

Returns ​

Promise<RelationshipsResult>

RelationshipsResult Subscribe result

Since ​

1.0.0

Throws ​

If user identifier is invalid

Example ​

javascript
const result = await rest.users.subscribe('username');
const resultById = await rest.users.subscribe(12345);

User Gifts ​

getGifts() ​

GET /user/{user_tag}/gifts No API Docs

getGifts(user, page): Promise<Gift[]>

Gets user gifts

Parameters ​

user ​

User ({tag}/{id}/u{id})

string | number

page ​

number = 0

Page number (default 0)

Returns ​

Promise<Gift[]>

Array of Gift objects

Since ​

1.0.0

Throws ​

If parameters are invalid

Example ​

javascript
const gifts = await rest.users.getGifts('username');
const giftsById = await rest.users.getGifts(12345, 1);

gifts() ​

GET /user/{user_tag}/gifts No API Docs

gifts(page): Promise<Gift[]>

Gets current user's gifts

Parameters ​

page ​

number = 0

Page number (default 0)

Returns ​

Promise<Gift[]>

Array of Gift objects

Since ​

1.0.0

Throws ​

If user not found in cache or page is invalid

Example ​

javascript
const gifts = await rest.users.gifts();
const nextPage = await rest.users.gifts(1);

Users Core ​

find() ​

find(payload, page): Promise<UserModel[]>

Find users

Parameters ​

payload ​

FindUserPayload

Search filters

page ​

number = 0

Page number (default 0)

Returns ​

Promise<UserModel[]>

User list

Since ​

1.0.0

Deprecated ​

Use rest.search.users() instead

Example ​

javascript
// Use rest.search.users() instead
const users = await rest.search.users({
  sort: 0,
  country: 0,
  region: 0,
  city: 0,
  worksAt: "",
  relationships: 0,
  online: 0,
  avatar: 0
});

get() ​

GET /user/{user_tag} API Docs

get(user): Promise<UserModel>

Gets user by identifier

Parameters ​

user ​

User ({tag}/{id}/u{id})

string | number

Returns ​

Promise<UserModel>

UserModel User information

Since ​

1.0.0

Throws ​

If user identifier is invalid

Example ​

javascript
const user = await rest.users.get('username');
const userById = await rest.users.get(12345);
const userByUid = await rest.users.get('u12345');

me() ​

GET /get_me API Docs

me(): Promise<UserModel>

Gets current user information

Returns ​

Promise<UserModel>

User Current user

Since ​

1.0.0

Example ​

javascript
const me = await rest.users.me();