/emojis

Returns information from the applications emoji or emoji list

This endpoint supports the Exclude and Paginate headers.

This endpoint is only on the BETA Version of the API and may be unstable.

Please report any & all bugs to the Support Server

Endpoint Headers:

• bot-token - Token of the Bot [String] (Required)

• apikey - Your Api Auth Key [String] (Required)

• app-id - ID of the Application [Snowflake] (Required)

• emoji - name, id, identifier or position (integer) of the emoji to be fetched [Snowflake] (Optional)

Endpoint URL Parameters

• simple - Retrieves a simpler set of data [Boolean] (Optional)

If no emoji was specified, it will grab all data and retrieve an Array, otherwise it will grab the one specified and retrieve an Object.

This will affect how to grab your data!

Examples:

Data API version required. Must replace <version> with either release or beta.

Bot Designer for Discord

Example usage of /client/emojis endpoint using BDFD

  $httpAddHeader[apikey;<YOUR-API-KEY>]
  $httpAddHeader[bot-token;<YOUR-BOT-TOKEN>]
  $httpAddHeader[app-id;1064100501764968488] 
  $httpAddHeader[emoji;coolemoji1] $c[Optional header]
 
 $httpGet[https://bdfddata.rickyjs.xyz/<version>/client/emojis]
 
 $httpResult OR $httpResult[details]

Discord.js

Example usage of /client/emojis endpoint using Discord.js

const axios = require('axios');
(async () => {
    return await axios.get('https://bdfddata.rickyjs.xyz/<version>/client/emojis', {
        headers: {
            "apikey": "<YOUR-API-KEY>",
            "bot-token": "<YOUR-BOT-TOKEN>",
            "app-id": "1064100501764968488",
            "emoji": "1064859897956663336" // Optional header
        }
    }).then(res => res.data)
})()

Possible Responses (Codes)

Code 200 (Simple Not Used)

API succeeded and details were fetched.

{
  "status": 200,
  "details": {
    "items": [
      {
        "animated": true,
        "available": true,
        "id": "123456789",
        "managed": false,
        "name": "coolemoji1",
        "require_colons": true,
        "roles": []
      },
      {
        "animated": false,
        "available": true,
        "id": "987654321",
        "managed": false,
        "name": "eoolemoji2",
        "require_colons": true,
        "roles": []
      }
    ]
  }
}

Code 200 (Simple Used)

API succeeded and details were fetched.

[
  {
    "status": 200,
    "details": {
      "animated": true,
      "id": "123456789",
      "identifier": "<:coolemoji1:123456789>",
      "name": "coolemoji1"
    }
  },
  {
    "animated": false,
    "id": "987654321",
    "identifier": "<:coolemoji2:987654321>",
    "name": "coolemoji2"
  }
]

Code 400

An error occurred that stopped execution.

{
  status: 400
  error: 'Cannot read ...  (This can vary)'
}

Code 401

Invalid bot token was provided.

{
  status: 401,
  details: { message: '401: Unauthorized', code: 0 }
}

Code 404

An emoji header was provided, but did not match any records.

{
  status: 404,
  error: "Emoji not found"
}