VRChat.Miscellaneous (vrchat v1.20.0)
View SourceAPI calls for all endpoints tagged Miscellaneous
.
Summary
Functions
Get Assigned Permissions Returns a list of all permissions currently granted by the user. Permissions are assigned e.g. by subscribing to VRC+.
Fetch API Config
API config contains configuration that the clients needs to work properly. Currently the most important value here is clientApiKey
which is used for all other API endpoints.
Download CSS Fetches the CSS code to the frontend React website.
Current Online Users Returns the current number of online users. NOTE: The response type is not a JSON object, but a simple JSON integer.
Check API Health
Gets the overall health status, the server name, and the current build version tag of the API. DEPRECATED: VRChat has suddenly restricted this endpoint for unknown reasons, and now always return 401 Unauthorized.
Show Information Notices
IPS (Info Push System) is a system for VRChat to push out dynamic information to the client. This is primarily used by the Quick-Menu info banners, but can also be used to e.g. alert you to update your game to the latest version. include
is used to query what Information Pushes should be included in the response. If include is missing or empty, then no notices will normally be returned. This is an "any of" search. require
is used to limit what Information Pushes should be included in the response. This is usually used in combination with include
, and is an "all of" search.
Download JavaScript Fetches the JavaScript code to the frontend React website.
Get Permission
Returns a single permission. This endpoint is pretty useless, as it returns the exact same information as /auth/permissions
.
Current System Time Returns the current time of the API server. NOTE: The response type is not a JSON object, but a simple JSON string.
Functions
@spec get_assigned_permissions( Tesla.Env.client(), keyword() ) :: {:ok, [VRChat.Model.Permission.t()]} | {:ok, VRChat.Model.Error.t()} | {:error, Tesla.Env.t()}
Get Assigned Permissions Returns a list of all permissions currently granted by the user. Permissions are assigned e.g. by subscribing to VRC+.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters
Returns
{:ok, [%Permission{}, ...]}
on success{:error, Tesla.Env.t}
on failure
@spec get_config( Tesla.Env.client(), keyword() ) :: {:ok, VRChat.Model.ApiConfig.t()} | {:error, Tesla.Env.t()}
Fetch API Config
API config contains configuration that the clients needs to work properly. Currently the most important value here is clientApiKey
which is used for all other API endpoints.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters
Returns
{:ok, VRChat.Model.ApiConfig.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_css( Tesla.Env.client(), keyword() ) :: {:ok, VRChat.Model.Error.t()} | {:ok, String.t()} | {:error, Tesla.Env.t()}
Download CSS Fetches the CSS code to the frontend React website.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters:variant
(String.t): Specifies whichvariant
of the site. Public is the end-user site, whileinternal
is the staff-only site with special pages for moderation and management.:branch
(String.t): Specifies which git branch the site should load frontend source code from.
Returns
{:ok, String.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_current_online_users( Tesla.Env.client(), keyword() ) :: {:ok, integer()} | {:error, Tesla.Env.t()}
Current Online Users Returns the current number of online users. NOTE: The response type is not a JSON object, but a simple JSON integer.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters
Returns
{:ok, integer()}
on success{:error, Tesla.Env.t}
on failure
@spec get_health( Tesla.Env.client(), keyword() ) :: {:ok, VRChat.Model.ApiHealth.t()} | {:error, Tesla.Env.t()}
Check API Health
Gets the overall health status, the server name, and the current build version tag of the API. DEPRECATED: VRChat has suddenly restricted this endpoint for unknown reasons, and now always return 401 Unauthorized.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters
Returns
{:ok, VRChat.Model.ApiHealth.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_info_push( Tesla.Env.client(), keyword() ) :: {:ok, [VRChat.Model.InfoPush.t()]} | {:error, Tesla.Env.t()}
Show Information Notices
IPS (Info Push System) is a system for VRChat to push out dynamic information to the client. This is primarily used by the Quick-Menu info banners, but can also be used to e.g. alert you to update your game to the latest version. include
is used to query what Information Pushes should be included in the response. If include is missing or empty, then no notices will normally be returned. This is an "any of" search. require
is used to limit what Information Pushes should be included in the response. This is usually used in combination with include
, and is an "all of" search.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters:require
(String.t): Tags to include (comma-separated). All of the tags needs to be present.:include
(String.t): Tags to include (comma-separated). Any of the tags needs to be present.
Returns
{:ok, [%InfoPush{}, ...]}
on success{:error, Tesla.Env.t}
on failure
@spec get_java_script( Tesla.Env.client(), keyword() ) :: {:ok, VRChat.Model.Error.t()} | {:ok, String.t()} | {:error, Tesla.Env.t()}
Download JavaScript Fetches the JavaScript code to the frontend React website.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters:variant
(String.t): Specifies whichvariant
of the site. Public is the end-user site, whileinternal
is the staff-only site with special pages for moderation and management.:branch
(String.t): Specifies which git branch the site should load frontend source code from.
Returns
{:ok, String.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_permission(Tesla.Env.client(), String.t(), keyword()) :: {:ok, VRChat.Model.Permission.t()} | {:ok, VRChat.Model.Error.t()} | {:error, Tesla.Env.t()}
Get Permission
Returns a single permission. This endpoint is pretty useless, as it returns the exact same information as /auth/permissions
.
Parameters
connection
(VRChat.Connection): Connection to serverpermission_id
(String.t): Must be a valid permission ID.opts
(keyword): Optional parameters
Returns
{:ok, VRChat.Model.Permission.t}
on success{:error, Tesla.Env.t}
on failure
@spec get_system_time( Tesla.Env.client(), keyword() ) :: {:ok, DateTime.t()} | {:error, Tesla.Env.t()}
Current System Time Returns the current time of the API server. NOTE: The response type is not a JSON object, but a simple JSON string.
Parameters
connection
(VRChat.Connection): Connection to serveropts
(keyword): Optional parameters
Returns
{:ok, DateTime.t}
on success{:error, Tesla.Env.t}
on failure