>>

Get Instance Info

GET/?<rate_limits>

Get information about the instance you’re sending this request to.

Most of this data comes from the instance’s configuration.

>>

Query Params

NameType
rate_limitsBoolean
>>

Response

InstanceInfo

FieldTypeDescription
instance_nameStringThe name of the instance.
descriptionString?The description of the instance.

This is between 1 and 2048 characters long.
versionStringThe Eludris version the instance is running.
message_limitNumberThe maximum length of a message’s content.
oprish_urlStringThe URL of the instance’s Oprish (REST API) endpoint.
pandemonium_urlStringThe URL of the instance’s Pandemonium (WebSocket API) endpoint.
effis_urlStringThe URL of the instance’s Effis (CDN) endpoint.
file_sizeNumberThe maximum file size (in bytes) of an asset.
attachment_file_sizeNumberThe maximum file size (in bytes) of an attachment.
rate_limits?InstanceRateLimitsThe rate limits that apply to the connected Eludris instance.

This is not present if the rate_limits query parameter is not set.
>>

Example

curl https://api.eludris.gay/?rate_limits

{
  "instance_name": "eludris",
  "description": "The *almost* official Eludris instance - ooliver.",
  "version": "0.3.2",
  "message_limit": 2000,
  "oprish_url": "https://api.eludris.gay",
  "pandemonium_url": "wss://ws.eludris.gay/",
  "effis_url": "https://cdn.eludris.gay",
  "file_size": 20000000,
  "attachment_file_size": 25000000,
  "rate_limits": {
    "oprish": {
      "info": {
        "reset_after": 5,
        "limit": 2
      },
      "message_create": {
        "reset_after": 5,
        "limit": 10
      },
      "rate_limits": {
        "reset_after": 5,
        "limit": 2
      }
    },
    "pandemonium": {
      "reset_after": 10,
      "limit": 5
    },
    "effis": {
      "assets": {
        "reset_after": 60,
        "limit": 5,
        "file_size_limit": 30000000
      },
      "attachments": {
        "reset_after": 180,
        "limit": 20,
        "file_size_limit": 500000000
      },
      "fetch_file": {
        "reset_after": 60,
        "limit": 30
      }
    }
  }
}