Expressões

Uma expressão é um emoji personalizado ou um adesivo que pertence a uma guilda. As rotas de metadados resolvem uma expressão a partir do seu próprio identificador, sem a necessidade de ser membro da guilda proprietária. As rotas de origem nomeiam a guilda proprietária apenas para um solicitante que possa vê-la.

Objeto	Rota	Recurso proprietário
Metadados de emoji	Obter metadados de emoji	Emojis de guilda
Metadados de adesivo	Obter metadados de adesivo	Adesivos de guilda
Guilda de origem de expressão	Obter guilda de origem de emoji, Obter guilda de origem de adesivo	Guildas

Toda rota aqui é somente leitura, e nenhuma escreve uma entrada de auditoria ou emite um Gateway Dispatch. As rotas de metadados retornam os metadados mesmo quando a guilda proprietária possui UNAVAILABLE_FOR_EVERYONE.

Quando um identificador não nomeia nenhuma expressão armazenada, o Decoding Chat retorna 404 UNKNOWN_EMOJI ou 404 UNKNOWN_STICKER. Uma expressão armazenada cuja guilda não existe mais retorna 404 UNKNOWN_GUILD.

Objeto de metadados de emoji

Um emoji personalizado, legível de fora da sua guilda. Ele adiciona a guilda proprietária ao objeto de emoji de guilda e descarta a classificação de conteúdo adulto e o enviador.

Estrutura

Campo	Tipo	Descrição
id¹	snowflake	O ID do emoji
guild_id²	snowflake	O ID da guilda que possui o emoji
name³	string	O nome do emoji (2-32 caracteres)
animated⁴	boolean	Se a imagem armazenada é animada
allow_cloning⁵	boolean	Se a guilda proprietária permite que o emoji seja copiado

¹ Único em todas as guildas, então o emoji é endereçável sem a sua guilda

² Este recurso não tem nome de guilda nem ícone de guilda

³ Criar emoji de guilda restringe o valor a letras ASCII, dígitos e sublinhado (_), e a clonagem copia o valor inalterado

⁴ O Decoding Chat detecta isso da imagem enviada na criação, e o valor nunca muda

⁵ True (verdadeiro) exatamente quando a guilda proprietária possui CLONE_EMOJI_ENABLED, e false (falso) para qualquer outra guilda

Todos os membros estão sempre presentes, e nenhum membro é anulável (nullable).

Exemplo

{
  "id": "1501314428688998182",
  "guild_id": "1489002177550843904",
  "name": "party_parrot",
  "animated": true,
  "allow_cloning": true
}

Objeto de metadados de adesivo

Um adesivo, legível de fora da sua guilda. Ele adiciona a guilda proprietária ao objeto de adesivo de guilda e descarta a descrição, as tags, a classificação de conteúdo adulto e o enviador.

Estrutura

Campo	Tipo	Descrição
id¹	snowflake	O ID do adesivo
guild_id²	snowflake	O ID da guilda que possui o adesivo
name³	string	O nome do adesivo (2-30 caracteres)
animated⁴	boolean	Se a imagem armazenada é animada
allow_cloning⁵	boolean	Se a guilda proprietária permite que o adesivo seja copiado

¹ Único em todas as guildas, então o adesivo é endereçável sem a sua guilda

² Este recurso não tem nome de guilda nem ícone de guilda

³ O valor aceita qualquer caractere

⁴ O Decoding Chat detecta isso da imagem enviada na criação, e o valor nunca muda

⁵ True exatamente quando a guilda proprietária possui CLONE_STICKER_ENABLED, e false para qualquer outra guilda

Todos os membros estão sempre presentes, e nenhum membro é anulável (nullable).

Exemplo

{
  "id": "1501314428688998183",
  "guild_id": "1489002177550843904",
  "name": "shipit",
  "animated": false,
  "allow_cloning": false
}

Objeto de guilda de origem de expressão

A guilda proprietária de uma expressão, reduzida ao necessário para nomeá-la e exibir seu selo (badge). Ele é menor que o objeto parcial de guilda e não possui campos de banner, splash ou splash embutido.

Estrutura

Campo	Tipo	Descrição
id	snowflake	O ID da guilda
name	string	O nome da guilda
icon¹	?string	Hash do ícone da guilda, ou null quando a guilda não armazenar nenhum
features²	array[string]	As funcionalidades de guilda em emblemas (badges) que a guilda possui

¹ Um hash de ícone animado possui o prefixo a_, e esse prefixo é removido do valor retornado quando a guilda não possui ANIMATED_ICON

² Apenas VERIFIED, PARTNERED e DISCOVERABLE podem aparecer, cada um no máximo uma vez e nessa ordem, e todas as outras funcionalidades que a guilda possui são deixadas de fora

Todos os membros estão sempre presentes, e apenas icon é anulável (nullable).

Exemplo

{
  "id": "1489002177550843904",
  "name": "Ada's Workshop",
  "icon": "a_9f2c1d4e",
  "features": ["VERIFIED", "DISCOVERABLE"]
}

Obter metadados de emoji

GET/v1/emojis/{emoji_id}/metadata

Bot

Retorna o objeto de metadados de emoji de qualquer emoji de guilda. A rota não requer adesão à guilda proprietária e não avalia nenhuma permissão.

Parâmetros de caminho

Campo	Tipo	Descrição
emoji_id	snowflake	O ID do emoji

Resposta

Status	Corpo	Condição
200	objeto metadados de emoji	Os metadados foram retornados
404¹	resposta de erro	O emoji não existe, ou a sua guilda proprietária não existe mais

¹ O código de erro é UNKNOWN_EMOJI para um emoji ausente e UNKNOWN_GUILD quando o registro do emoji sobrevive, mas a guilda não

Limite de taxa

60 requisições a cada 10 segundos para cada usuário autenticado, no bucket guild:emoji:metadata::user_id, e todo emoji que a conta pesquisa usa desse único orçamento.

Obter metadados de adesivo

GET/v1/stickers/{sticker_id}/metadata

Bot

Retorna o objeto de metadados de adesivo de qualquer adesivo de guilda. A rota não requer adesão à guilda proprietária e não avalia nenhuma permissão.

Parâmetros de caminho

Campo	Tipo	Descrição
sticker_id	snowflake	O ID do adesivo

Resposta

Status	Corpo	Condição
200	objeto metadados de adesivo	Os metadados foram retornados
404¹	resposta de erro	O adesivo não existe, ou a sua guilda proprietária não existe mais

¹ O código de erro é UNKNOWN_STICKER para um adesivo ausente e UNKNOWN_GUILD quando o registro do adesivo sobrevive, mas a guilda não

Limite de taxa

60 requisições a cada 10 segundos para cada usuário autenticado, no bucket guild:sticker:metadata::user_id, e todo adesivo que a conta pesquisa usa desse único orçamento.

Obter guilda de origem de emoji

GET/v1/emojis/{emoji_id}/source

Bot

Retorna o objeto de guilda de origem de expressão da guilda que possui um emoji. O Decoding Chat lê a guilda a partir do gateway, não do armazenamento. A guilda é retornada quando ela é descobrível, ou quando o solicitante for um membro dela.

Parâmetros de caminho

Campo	Tipo	Descrição
emoji_id	snowflake	O ID do emoji

Resposta

Status	Corpo	Condição
200	objeto guilda de origem de expressão	O solicitante pode ver a guilda proprietária
404¹	resposta de erro	O emoji não existe, ou a guilda proprietária é privada para o solicitante ou indisponível

¹ O código de erro é UNKNOWN_EMOJI para um emoji ausente, e UNKNOWN_GUILD quando a guilda proprietária não for descobrível e o solicitante não for membro dela, ou quando o gateway não conseguir acessá-la.

Limite de taxa

60 requisições a cada 10 segundos para cada usuário autenticado, no bucket guild:emoji:source::user_id, e todo emoji que a conta pesquisa usa desse único orçamento.

Obter guilda de origem de adesivo

GET/v1/stickers/{sticker_id}/source

Bot

Retorna o objeto de guilda de origem de expressão da guilda que possui um adesivo. O Decoding Chat lê a guilda a partir do gateway, não do armazenamento. A guilda é retornada quando ela é descobrível, ou quando o solicitante for um membro dela.

Parâmetros de caminho

Campo	Tipo	Descrição
sticker_id	snowflake	O ID do adesivo

Resposta

Status	Corpo	Condição
200	objeto guilda de origem de expressão	O solicitante pode ver a guilda proprietária
404¹	resposta de erro	O adesivo não existe, ou a guilda proprietária é privada para o solicitante ou indisponível

¹ O código de erro é UNKNOWN_STICKER para um adesivo ausente, e UNKNOWN_GUILD quando a guilda proprietária não for descobrível e o solicitante não for membro dela, ou quando o gateway não conseguir acessá-la.

Limite de taxa

60 requisições a cada 10 segundos para cada usuário autenticado, no bucket guild:sticker:source::user_id, e todo adesivo que a conta pesquisa usa desse único orçamento.