get-identity-summaries

GetIdentitySummaries

Fetches a list of identity summaries.

Query Parameters

identity_ids string[] required
Possible values: Value must match regular expression ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
A list of identity IDs.

Responses

GetIdentitySummaries 200 response

Schema

identities object[] required
A list of identity summaries.
identity_id string required
Possible values: Value must match regular expression ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
A universally unique identifier.
display_name string required
Possible values: 1 ≤ length ≤ 24, Value must match regular expression ^(?:[^ \n\r] ?)+[^ \n\r]$
Represent a resource's readable display name.
account_number int32 required
Possible values: value ≤ 9999
Identity profile account number (#1234).

These are assigned in addition to an identity's display name in order to allow multiple identities to have the same display name while still providing a unique handle.

These are unique to each display name; you can have multiple accounts with different display names and the same account number.
avatar_url string required
The URL of this identity's avatar image.
presence object
Information about the identity's current status, party, and active game.
update_ts date-time required
RFC3339 timestamp.
status string required
Possible values: [online, away, offline]
The current status of an identity. This helps players understand if another player is currently playing or has their game in the background.
game_activity object
The game an identity is currently participating in.
game object required
A game handle.
game_id string required
Possible values: Value must match regular expression ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
A universally unique identifier.
name_id string required
Possible values: 1 ≤ length ≤ 16, Value must match regular expression ^[a-zA-Z0-9](?:[a-zA-Z0-9]-?)+[a-zA-Z0-9]$
A human readable short identifier used to references resources.

Different than a rivet.common#Uuid because this is intended to be human readable.

Different than rivet.common#DisplayName because this should not include special characters and be short.
display_name string required
Possible values: 1 ≤ length ≤ 24, Value must match regular expression ^(?:[^ \n\r] ?)+[^ \n\r]$
Represent a resource's readable display name.
logo_url string
The URL of this game's logo image.
banner_url string
The URL of this game's banner image.
message string required
A short activity message about the current game activity.
public_metadata
JSON data seen by anyone.
mutual_metadata
JSON data seen only by the given identity and their mutual followers.
party object
A party handle.
party_id string required
Possible values: Value must match regular expression ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
A universally unique identifier.
create_ts date-time required
RFC3339 timestamp.
activity required
A union representing the activity of a given party.
external object required
External links for a party.
chat string required
A link to the given party's chat thread.
is_registered boolean required
Whether or not this identity is registered with a linked account.
external object required
External links for an identity.
profile string required
A link to this identity's profile page.
settings string
A link to the Rivet settings page.
chat string
A link to a chat page with the given identity.
following boolean required
Whether or not the requestee's identity is following this identity.
is_following_me boolean required
Whether or not this identity following the requestee's identity.
is_mutual_following boolean required
Whether or not this identity is both followng and is followed by the requestee's identity.

GetIdentitySummaries​

GetIdentitySummaries