Usuários
Um usuário é uma conta do Decoding Chat. Outra conta vê o objeto de usuário parcial, e o proprietário vê o objeto de usuário. A mutação da conta reside em Usuário atual.
Toda rota nesta página aceita um token de sessão de usuário ou um token de bot. Uma credencial de portador (bearer credential) OAuth2 é rejeitada com 403 ACCESS_DENIED.
| Objeto | Propósito |
|---|---|
| Usuário parcial | Representação de conta pública embutida em todos os lugares |
| Usuário | Representação privada do proprietário |
| Configurações do usuário | Registro de configurações da conta inteira |
| Perfil de usuário completo | Leitura de perfil para uma conta alvo |
Objeto de usuário parcial
Seção intitulada “Objeto de usuário parcial”A representação pública da conta embutida por mensagens, relacionamentos, membros da guilda e aplicações.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| id | snowflake | O snowflake que identifica a conta |
| username | string | O nome de usuário da conta (1-32 letras ASCII, dígitos, ou sublinhados) |
| discriminator | string | O discriminador da conta, quatro dígitos decimais com zeros à esquerda |
| global_name | ?string | O nome de exibição da conta, ou nulo quando nenhum é definido |
| avatar1 | ?string | O hash de imagem do avatar da conta, ou nulo quando nenhum é definido |
| avatar_color | ?integer | A cor RGB compactada de 24 bits derivada do avatar armazenado, ou nula |
| bot? | boolean | Se a conta é um bot, omitido quando for falso |
| system? | boolean | Se a conta é uma conta de sistema do Decoding Chat, omitido quando for falso |
| flags | integer | Sinalizadores de usuário público |
| mention_flags? | integer | Preferência de menção de resposta, omitido quando a conta não tem preferência |
1 O hash de um avatar animado possui o prefixo a_, e o prefixo é removido enquanto a conta não tem direito a um avatar animado
Exemplo
Seção intitulada “Exemplo”{ "id": "1501314428688998182", "username": "aria", "discriminator": "0042", "global_name": "Aria", "avatar": "a_2f1c9d7be4a350c8", "avatar_color": 5793266, "flags": 8}Sinalizadores de usuário público
Seção intitulada “Sinalizadores de usuário público”flags contém o subconjunto publicamente visível dos sinalizadores armazenados da conta. STAFF também é removido de flags enquanto a conta possui o sinalizador armazenado STAFF_HIDDEN.
| Valor | Nome | Descrição |
|---|---|---|
| 1 << 0 | STAFF | A conta é membro da equipe (staff) |
| 1 << 2 | PARTNER | A conta é uma parceira |
| 1 << 3 | BUG_HUNTER | A conta é uma caçadora de bugs |
| 1 << 4 | FRIENDLY_BOT | O bot aceita pedidos de amizade de usuários |
| 1 << 5 | FRIENDLY_BOT_MANUAL_APPROVAL | O bot requer aprovação manual para pedidos de amizade |
| 1 << 6 | SPAMMER | A conta foi sinalizada como spammer |
Preferências de menção de resposta
Seção intitulada “Preferências de menção de resposta”A preferência para a conta inteira aplicada quando outra conta responde a uma das mensagens desta conta. mention_flags é exatamente um dos valores abaixo. É omitido de um usuário serializado enquanto o valor armazenado é NO_PREFERENCE.
| Valor | Nome | Descrição |
|---|---|---|
| 0 | NO_PREFERENCE | O remetente escolhe se cada resposta menciona esta conta, sem aviso quando a menção é alternada |
| 1 | PREFER_MENTION | As respostas mencionam esta conta por padrão, e o remetente é avisado quando desabilita a menção |
| 2 | PREFER_NO_MENTION | As respostas omitem a menção por padrão, e o remetente é avisado quando a habilita |
Um membro de guilda possui a mesma enumeração em seu próprio mention_flags, onde NO_PREFERENCE herda o valor de conta.
Objeto de usuário
Seção intitulada “Objeto de usuário”A representação privada da conta atual, retornada por Obter usuário atual e por cada operação que altera a conta. Ela estende o objeto de usuário parcial.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| id | snowflake | O snowflake que identifica a conta |
| username | string | O nome de usuário da conta (1-32 letras ASCII, dígitos ou sublinhados) |
| discriminator | string | O discriminador da conta, quatro dígitos decimais com zeros à esquerda |
| global_name | ?string | O nome de exibição da conta, ou nulo quando nenhum é definido |
| avatar1 | ?string | O hash da imagem do avatar da conta, ou nulo quando nenhum é definido |
| avatar_color | ?integer | A cor RGB de 24 bits compactada derivada do avatar armazenado, ou nula |
| bot? | boolean | Se a conta é um bot, omitido quando falso |
| system? | boolean | Se a conta é uma conta de sistema do Decoding Chat, omitido quando falso |
| flags | integer | Sinalizadores de usuário público |
| mention_flags? | integer | Preferência de menção de resposta, omitido quando a conta não tem preferência |
| is_staff | boolean | Se a conta tem o sinalizador de equipe (staff), inclusive quando esse sinalizador está oculto em flags |
| acls2 3 | array[string] | As entradas de controle de acesso de Admin possuídas pela conta |
| traits3 4 | array[string] | Os traços da conta, em ordem |
| email5 | ?string | O endereço de e-mail da conta, ou nulo quando não houver |
| email_bounced?3 | boolean | Se o provedor de correio marcou o e-mail atual como devolvido (bounced) |
| phone6 | ?string | Sempre nulo |
| has_verified_phone | boolean | Se a verificação por telefone está completa |
| bio | ?string | A biografia do perfil, ou nulo quando nenhuma for definida |
| pronouns | ?string | Os pronomes do perfil, ou nulo quando nenhum for definido |
| accent_color | ?integer | A cor de destaque do perfil como RGB compactado de 24 bits, ou nulo quando não houver |
| timezone?7 | ?string | O identificador de fuso horário da IANA armazenado para a conta, ou nulo quando nenhum for definido |
| timezone_privacy_flags?7 | integer | Sinalizadores de privacidade de campo do perfil aplicados ao fuso horário do perfil |
| banner8 | ?string | O hash de imagem do banner do perfil, ou nulo quando não houver banner ou falte o direito |
| banner_color | ?integer | A cor RGB de 24 bits compactada derivada do banner armazenado, ou nulo |
| mfa_enabled3 9 | boolean | Se algum autenticador está configurado |
| authenticator_types?3 9 | array[integer] | Tipos de autenticador configurados para a conta |
| verified5 | boolean | Se o e-mail da conta está verificado |
| premium_type10 | ?integer | Tipo premium |
| premium_since3 10 | ?ISO8601 timestamp | O momento em que o premium foi ativado pela primeira vez, ou nulo |
| premium_until3 11 | ?ISO8601 timestamp | O fim do acesso premium atual, ou nulo quando não houver período premium armazenado |
| premium_will_cancel3 | boolean | Se o premium de assinatura será cancelado no limite de faturamento |
| premium_billing_cycle3 | ?string | O ciclo de faturamento premium, ou nulo |
| premium_lifetime_sequence3 | ?integer | A sequência premium vitalícia, ou nula |
| premium_grace_ends_at12 | ?ISO8601 timestamp | O fim do intervalo de tolerância pós-cancelamento, ou nulo quando a conta não estiver em tolerância |
| premium_discriminator13 | boolean | Se o discriminador atual foi selecionado com um direito premium |
| premium_badge_hidden3 | boolean | Se o selo premium está oculto do perfil público |
| premium_badge_masked3 | boolean | Se um selo vitalício é apresentado como um selo de assinatura comum |
| premium_badge_timestamp_hidden3 | boolean | Se a hora de ativação premium está oculta do perfil público |
| premium_badge_sequence_hidden3 | boolean | Se a sequência vitalícia está oculta do perfil público |
| premium_purchase_disabled3 | boolean | Se a compra premium está desabilitada para a conta |
| premium_enabled_override3 | boolean | Se uma sobreposição administrativa concede direitos premium |
| premium_perks_disabled3 | boolean | Se os direitos premium estão suspensos para a conta |
| force_inbound_phone_verification?14 | boolean | O interruptor de depuração que força o fluxo de verificação de telefone de entrada |
| password_last_changed_at3 | ?ISO8601 timestamp | A hora da mudança de senha mais recente, ou nula |
| last_voice_activity_sharing_change_at15 | ?ISO8601 timestamp | O momento da mudança mais recente de compartilhamento de atividade de voz em massa, ou nulo |
| required_actions3 16 | array[string] | As ações requeridas ordenadas que a conta deve concluir antes do uso irrestrito |
| nsfw_allowed3 17 | boolean | Se a conta pode acessar conteúdo com restrição de idade |
| has_dismissed_premium_onboarding3 18 | boolean | Se o onboarding premium foi descartado |
| has_ever_purchased3 | boolean | Se a conta já completou uma compra |
| has_unread_gift_inventory3 19 | boolean | Se o inventário de presentes tem itens não lidos |
| unread_gift_inventory_count3 19 | integer | O número de itens não lidos do inventário de presentes |
| pending_bulk_message_deletion3 | ?objeto de exclusão em massa de mensagens pendente | A exclusão de mensagens que a conta agendou para si mesma, ou nulo quando não houver nenhuma pendente |
| age_verified_adult? | boolean | Se a verificação de idade adulta está completa, omitido quando for falso |
| terms_agreed_at | ?ISO8601 timestamp | O momento da aceitação dos termos mais recente, ou nulo |
| privacy_agreed_at | ?ISO8601 timestamp | O momento da aceitação mais recente da política de privacidade, ou nulo |
1 Um hash de avatar animado tem o prefixo a_, e o prefixo é removido enquanto a conta não tiver direito a avatar animado
2 O array é vazio para uma conta sem acesso de Admin, e é completamente substituído por Definir ACLs de usuário. É independente de is_staff
3 O campo é neutralizado para uma credencial de portador (bearer) OAuth2, conforme descrito abaixo
4 O valor premium está presente exatamente quando os direitos premium estão ativos, independentemente do conjunto de traços armazenados, e cada outro traço armazenado é retornado ordenado
5 Para uma credencial de portador OAuth2 sem o escopo email, email é null
6 Sempre nulo
7 O par está presente apenas enquanto a conta possuir a bandeira da equipe (staff), e ausente para todas as outras contas
8 O hash do banner não é retornado enquanto a conta não tiver o direito de banner animado, que todo banner de perfil requer
9 mfa_enabled é verdadeiro exatamente quando ao menos um autenticador está configurado. Uma conta sem autenticador omite authenticator_types
10 O valor é forçado para 0 e premium_since é forçado para null enquanto os direitos premium não estiverem ativos
11 premium_until é a data mais tarde entre o término da assinatura e qualquer extensão de presente empilhada. O Decoding Chat o reporta mesmo quando os direitos premium não estão mais ativos
12 Após passar premium_until, os direitos premium permanecem ativos até esse momento. Enquanto o valor for nulo, eles permanecem ativos por 3 dias após premium_until
13 O sinalizador é definido quando a conta altera seu nome de usuário ou discriminador mantendo um premium não vitalício, e depois que o acesso premium termina, o Decoding Chat substitui o discriminador por um recém-gerado na próxima vez que a conta iniciar uma sessão de Gateway
14 O campo é declarado, mas nunca preenchido, portanto está ausente em todas as respostas
15 O valor orienta o tempo de recarga de 24 horas para alterar o estado padrão de compartilhamento de atividades de voz
16 O array é vazio quando a conta não possui nenhum sinalizador de atividade suspeita armazenado, não tem e-mail, ou quando a política da conta isenta seu endereço de e-mail das ações requeridas
17 A uma conta de bot sempre é permitido acesso, e uma conta de usuário é permitida apenas quando a data de nascimento registrada a posiciona em 18 anos ou mais
18 O valor é falso enquanto os direitos premium não estiverem ativos, mesmo quando um descarte foi registrado antes
19 Relata se presentes não lidos existem e quantos. Uma conta sem presentes reporta false e 0
Rotas de recuperação permanecem abertas para uma conta restrita. Elas são: Obter usuário atual, Modificar usuário atual, Obter configurações do usuário atual, cada rota de alteração de e-mail e verificação por telefone, Reenviar verificação de e-mail, listagem e término de sessões e as rotas OAuth2.
Um requisito desaparece da lista assim que for atendido. Uma operação Admin não aplica nenhum portal de atividade suspeita.
Objeto de exclusão em massa de mensagens pendente
Seção intitulada “Objeto de exclusão em massa de mensagens pendente”Uma exclusão agendada de cada mensagem que a conta enviou. O campo é este objeto apenas enquanto a exclusão solicitada através de Solicitar exclusão em massa de mensagens ainda aguarda execução.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| scheduled_at | ISO8601 timestamp | O horário em que a exclusão ocorre |
| channel_count1 | integer | O número de canais contendo uma mensagem que será deletada |
| message_count1 | integer | O número de mensagens que serão deletadas |
1 Ambas as contagens são computadas quando a exclusão é agendada e não são recalculadas enquanto ela aguarda
Tipos de autenticador
Seção intitulada “Tipos de autenticador”| Valor | Nome | Descrição |
|---|---|---|
| 0 | TOTP | Autenticador de senha de uso único baseado em tempo |
| 2 | WEBAUTHN | Autenticador WebAuthn |
O valor 1 não está atribuído. Qualquer valor de autenticador armazenado fora deste registro é excluído de authenticator_types.
Tipos premium
Seção intitulada “Tipos premium”| Valor | Nome | Descrição |
|---|---|---|
| 0 | NONE | Nenhuma assinatura premium |
| 1 | SUBSCRIPTION | Assinatura premium ativa |
| 2 | LIFETIME | Assinatura premium vitalícia |
Ações requeridas
Seção intitulada “Ações requeridas”Cada entrada é uma string exata no array required_actions do objeto de usuário, ordenado pela ordem de registro abaixo. O Decoding Chat remove um requisito que a conta já satisfaz e remove um requisito implícito por um mais rigoroso retido.
| Valor | Descrição |
|---|---|
| REQUIRE_VERIFIED_EMAIL | A conta precisa de um endereço de e-mail verificado |
| REQUIRE_REVERIFIED_EMAIL | A conta precisa verificar seu endereço de e-mail novamente |
| REQUIRE_VERIFIED_PHONE | A conta precisa de um número de telefone verificado |
| REQUIRE_REVERIFIED_PHONE | A conta precisa verificar seu número de telefone novamente |
| REQUIRE_VERIFIED_EMAIL_OR_VERIFIED_PHONE | A conta precisa ou de um endereço de e-mail verificado ou de um número de telefone verificado |
| REQUIRE_REVERIFIED_EMAIL_OR_VERIFIED_PHONE | A conta precisa verificar seu endereço de e-mail novamente ou possuir um número de telefone verificado |
| REQUIRE_VERIFIED_EMAIL_OR_REVERIFIED_PHONE | A conta precisa de um endereço de e-mail verificado ou precisa verificar seu número de telefone novamente |
| REQUIRE_REVERIFIED_EMAIL_OR_REVERIFIED_PHONE | A conta precisa verificar novamente ou o e-mail ou o número de telefone |
| REQUIRE_INBOUND_PHONE_VERIFICATION1 | A conta precisa concluir a verificação de telefone enviando um SMS para o número de entrada da instância |
1 A entrada aparece apenas enquanto houver um requisito telefônico pendente. Um requisito de entrada armazenado sem outro requisito telefônico adiciona REQUIRE_VERIFIED_PHONE ao array
Sinalizadores de privacidade de campo do perfil
Seção intitulada “Sinalizadores de privacidade de campo do perfil”Um campo cujo valor de flags é 0 não é visível a ninguém, nem na própria leitura do perfil do proprietário.
| Valor | Nome | Descrição |
|---|---|---|
| 1 << 0 | EVERYONE | Qualquer pessoa permitida a ver o perfil completo pode ver o campo |
| 1 << 1 | FRIENDS | Amigos podem ver o campo |
| 1 << 2 | MUTUAL_GUILDS | Membros de uma guilda mútua podem ver o campo |
Objeto de configurações de usuário
Seção intitulada “Objeto de configurações de usuário”O registro de configurações da conta completa, com um campo por configuração. synced_preferences contém um instantâneo Protobuf codificado em base64 definido na referência Protobuf de configurações do usuário. O Decoding Chat armazena esse instantâneo para clientes e nunca o interpreta.
O objeto de atualização de configurações de usuário lista os campos que uma atualização aceita e o que cada campo fornecido ou omitido faz no valor armazenado. Ambas as operações de configuração retornam este objeto, assim como Ready e User Settings Update. Cada campo abaixo está sempre presente.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| status | string | Status de presença |
| status_resets_at | ?ISO8601 timestamp | O momento em que a redefinição programada do status se aplica, ou nulo |
| status_resets_to | ?string | Status de presença aplicado pela redefinição programada, ou nulo |
| theme | string | Valor do tema |
| locale | string | O locale da interface |
| restricted_guilds1 | array[snowflake] | As guildas onde as mensagens diretas de membros são restritas |
| bot_restricted_guilds1 | array[snowflake] | As guildas onde as mensagens diretas de bot são restritas |
| default_guilds_restricted | boolean | Se as guildas recém-ingressadas restringem as mensagens diretas de membros |
| bot_default_guilds_restricted | boolean | Se as guildas recém-ingressadas restringem as mensagens diretas de bots |
| inline_attachment_media | boolean | Se as mídias em anexo são renderizadas inline |
| inline_embed_media | boolean | Se a mídia embutida é renderizada inline |
| gif_auto_play | boolean | Se as mídias GIF reproduzem automaticamente |
| render_embeds | boolean | Se as mídias embutidas na mensagem são renderizadas |
| render_reactions | boolean | Se as reações de mensagem são renderizadas |
| animate_emoji | boolean | Se emojis personalizados se animam |
| animate_stickers | integer | Configuração de animação de figurinha |
| render_spoilers | integer | Configuração de renderização de spoiler |
| message_display_compact | boolean | Se as mensagens utilizam exibição compacta |
| friend_source_flags | integer | Sinalizadores de fonte de amigo |
| incoming_call_flags | integer | Sinalizadores de chamadas recebidas |
| group_dm_add_permission_flags | integer | Sinalizadores de permissão para adicionar em Grupo DM |
| guild_folders2 | array[objeto de pasta de guilda] | O layout da barra lateral de guilda de propriedade do usuário |
| custom_status | ?objeto de status personalizado | O status personalizado atual, ou nulo quando não houver |
| afk_timeout | integer | O tempo ocioso em segundos antes de a conta ser apresentada como ausente |
| time_format | integer | Configuração de formato de tempo |
| developer_mode | boolean | Se o modo desenvolvedor está ativado |
| trusted_domains3 | array[string] | Os domínios de link externo que a conta confia |
| default_hide_muted_channels | boolean | Se as guildas recém-ingressadas ocultam canais silenciados |
| sensitive_content_friend_dm_filter | integer | Filtro de mídia sensível para mensagens diretas de amigos |
| sensitive_content_non_friend_dm_filter | integer | Filtro de mídia sensível para mensagens diretas de não amigos |
| sensitive_content_guild_filter | integer | Filtro de mídia sensível da guilda |
| suppress_unprivileged_self_mentions4 | boolean | Se menções diretas ou menções de resposta de usuários sem privilégios são suprimidas |
| suppress_unprivileged_self_mentions_bypass_user_ids4 5 | array[snowflake] | Os usuários isentos de supressão de menção |
| staff_dm_access_user_ids4 5 | array[snowflake] | Os usuários com acesso concedido para enviar mensagem direta à equipe |
| synced_preferences6 | string | A mensagem de preferências sincronizadas em base64 |
| profile_privacy | integer | Nível de privacidade do perfil |
| default_share_voice_activity7 | boolean | Se uma relação de amizade recém-aceita começa com o compartilhamento de atividade de voz ativado |
1 Identificadores duplicados são removidos quando o array é escrito
2 Uma conta com um layout armazenado vazio que ainda possui uma ordenação de guilda legada recebe uma pasta não categorizada contendo essa ordenação. Uma conta com nenhum dos dois recebe um array vazio
3 A única entrada * confia em todos os domínios, e não pode ser combinada com um domínio concreto
4 O campo só pode ser escrito por uma conta da equipe e é redefinido para o seu valor zero a cada atualização de configurações de uma conta normal
5 Identificadores duplicados são removidos e o array é retornado em ordem ascendente
6 A mensagem é fluxer.user.preferences.v1.SyncedPreferences. A string vazia significa que nada foi sincronizado ainda. A mensagem decodificada não pode exceder 524288 bytes, o limite de 512 KiB
7 O campo é de leitura aqui e é modificado por Modificar compartilhamento de atividade de voz
Objeto de status personalizado
Seção intitulada “Objeto de status personalizado”Um status personalizado é o texto e o emoji armazenados nas configurações de usuário da conta.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| text | ?string | O texto do status (1-128 caracteres), ou nulo quando nenhum for definido |
| expires_at?1 | ISO8601 timestamp | O momento em que o status expira |
| emoji_id?1 | snowflake | O ID do emoji personalizado exibido ao lado do texto |
| emoji_name2 | ?string | O nome do emoji personalizado resolvido de emoji_id, o emoji Unicode fornecido diretamente, ou nulo |
| emoji_animated | boolean | Se o emoji personalizado selecionado é animado |
1 O campo é omitido quando o status não tem data de validade ou nenhum emoji personalizado
2 Um payload com emoji_id tem o seu emoji_name substituído pelo nome do emoji
Exemplo
Seção intitulada “Exemplo”{ "text": "enviando (shipping)", "expires_at": "2026-03-04T18:00:00.000Z", "emoji_id": "1501314428688998182", "emoji_name": "party_parrot", "emoji_animated": true}Objeto de pasta da guilda
Seção intitulada “Objeto de pasta da guilda”Uma entrada no layout da barra lateral de guildas de propriedade do usuário que é salva. Entrar numa guilda adiciona no início o ID dela à pasta não categorizada. Sair de uma guilda ou perdê-la remove o ID dela de todas as pastas e remove qualquer pasta não categorizada que a remoção esvazie, com ou sem nome.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| id1 | ?integer | O identificador da pasta |
| name | ?string | O nome da pasta, ou nulo se não houver um definido |
| color2 | ?integer | A cor da pasta no formato de cor RGB compactado de 24 bits |
| flags | integer | Sinalizadores da pasta da guilda |
| icon3 | string | Ícone da pasta da guilda |
| guild_ids4 | array[snowflake] | Os IDs das guildas na pasta, na ordem da barra lateral |
1 O valor -1 identifica a pasta sem categoria, que guarda as guildas não alocadas em uma pasta nomeada. Um layout guardado que a omite a tem no início do arquivo ao ser guardado
2 Uma pasta salva sem cor é salva com 0. O valor é nulo numa pasta sem categoria criada de um pedido de organização legado de guilda ou criado pela participação da guilda
3 Uma pasta salva sem um ícone é armazenada com folder
4 A escrita no layout mantém uma ocorrência do ID da guilda que aparece em mais de uma pasta, preferindo a pasta nomeada em detrimento da sem categoria
Exemplo
Seção intitulada “Exemplo”{ "id": -1, "name": null, "color": null, "flags": 0, "icon": "folder", "guild_ids": ["1501314428688998182", "1501314428688998183"]}Sinalizadores da pasta da guilda
Seção intitulada “Sinalizadores da pasta da guilda”| Valor | Nome | Descrição |
|---|---|---|
| 1 << 0 | SHOW_ICON_WHEN_COLLAPSED | Mostrar o ícone selecionado ao invés de miniaturas da guilda durante colapso |
Ícones da pasta da guilda
Seção intitulada “Ícones da pasta da guilda”| Valor | Descrição |
|---|---|
| folder | Ícone da pasta, aplicado quando nenhum ícone for fornecido |
| star | Ícone da estrela |
| heart | Ícone do coração |
| bookmark | Ícone do favorito (bookmark) |
| game_controller | Ícone de um controlador de jogo |
| shield | Ícone do escudo |
| music_note | Ícone da nota musical |
Configurações de animação da figurinha
Seção intitulada “Configurações de animação da figurinha”| Valor | Nome | Descrição |
|---|---|---|
| 0 | ALWAYS_ANIMATE | Sempre animar figurinhas (stickers) |
| 1 | ANIMATE_ON_INTERACTION | Animar figurinhas durante interação |
| 2 | NEVER_ANIMATE | Nunca animar figurinhas |
Configurações de renderização do spoiler
Seção intitulada “Configurações de renderização do spoiler”| Valor | Nome | Descrição |
|---|---|---|
| 0 | ALWAYS | Sempre revelar o conteúdo com spoiler |
| 1 | ON_CLICK | Revelar o conteúdo com spoiler após interação |
| 2 | IF_MODERATOR | Revelar conteúdo de spoiler para moderadores |
Configurações do formato de tempo
Seção intitulada “Configurações do formato de tempo”| Valor | Nome | Descrição |
|---|---|---|
| 0 | AUTO | Selecionar o formato de tempo por locale |
| 1 | TWELVE_HOUR | Usa o relógio de 12 horas |
| 2 | TWENTY_FOUR_HOUR | Usa o relógio de 24 horas |
Filtros de mídia sensível
Seção intitulada “Filtros de mídia sensível”| Valor | Nome | Descrição |
|---|---|---|
| 0 | SHOW | Mostrar a mídia sensível |
| 1 | BLUR | Borrar (blur) a mídia sensível até revelada |
| 2 | BLOCK | Ocultar a mídia sensível |
Filtros de mídia sensível da guilda
Seção intitulada “Filtros de mídia sensível da guilda”Canais da guilda aceitam somente estes valores.
| Valor | Nome | Descrição |
|---|---|---|
| 0 | SHOW | Mostrar a mídia sensível |
| 1 | BLUR | Borrar a mídia sensível até revelada |
Níveis de privacidade do perfil
Seção intitulada “Níveis de privacidade do perfil”Uma conta de bot nunca é sujeita à privacidade de perfil, e um agente que lê seu próprio perfil nunca é restrito.
| Valor | Nome | Descrição |
|---|---|---|
| 0 | ALL_GUILDS | Amigos e membros de qualquer guilda mútua podem acessar o perfil completo |
| 1 | SMALL_GUILDS_ONLY | Amigos e membros de uma guilda mútua com no máximo 200 membros podem acessar o perfil completo |
| 2 | FRIENDS_ONLY | Apenas amigos podem visualizar o perfil completo |
Sinalizadores de fonte de amigo
Seção intitulada “Sinalizadores de fonte de amigo”| Valor | Nome | Descrição |
|---|---|---|
| 1 << 0 | MUTUAL_FRIENDS | Aceitar pedidos de usuários com amigos em comum |
| 1 << 1 | MUTUAL_GUILDS | Aceitar pedidos de usuários de guildas mútuas |
| 1 << 2 | NO_RELATION | Aceitar pedidos sem haver relação estabelecida |
Sinalizadores de chamadas recebidas
Seção intitulada “Sinalizadores de chamadas recebidas”SILENT_EVERYONE se aplica a chamadas que outros sinalizadores já permitem. Quando fornecidos sinalizadores de política em conflito, FRIENDS_ONLY possui prevalência sobre NOBODY.
| Valor | Nome | Descrição |
|---|---|---|
| 1 << 0 | FRIENDS_OF_FRIENDS | Permitir chamadas de amigos de amigos |
| 1 << 1 | GUILD_MEMBERS | Permitir chamadas dos membros de guilda |
| 1 << 2 | EVERYONE | Permitir chamadas de todo mundo |
| 1 << 3 | FRIENDS_ONLY | Permitir chamadas apenas de amigos |
| 1 << 4 | NOBODY | Rejeitar todo tipo de chamada recebida |
| 1 << 5 | SILENT_EVERYONE | Receber chamadas permitidas de maneira silenciosa |
Sinalizadores de permissão para adicionar em Grupo DM
Seção intitulada “Sinalizadores de permissão para adicionar em Grupo DM”Quando fornecidos sinalizadores de política em conflito, FRIENDS_ONLY toma precedência sobre NOBODY, qual toma precedência em EVERYONE.
| Valor | Nome | Descrição |
|---|---|---|
| 1 << 0 | FRIENDS_OF_FRIENDS | Permitir que amigos de amigos adicione o usuário |
| 1 << 1 | GUILD_MEMBERS | Permitir membros da guilda a adicionar o usuário |
| 1 << 2 | EVERYONE | Permitir que todo o mundo adicione o usuário |
| 1 << 3 | FRIENDS_ONLY | Permitir somente a amigos adicionar o usuário |
| 1 << 4 | NOBODY | Prevenir que todo e qualquer usuário adicione o usuário |
Objeto de perfil do usuário
Seção intitulada “Objeto de perfil do usuário”As customizações do perfil em conta inteira inseridas dentro do objeto de perfil de usuário completo.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| bio1 | ?string | A biografia na conta inteira, ou nulo se não haver nenhuma configurada |
| pronouns1 | ?string | Os pronomes na conta inteira, ou nulo se não houver |
| banner2 | ?string | O hash da imagem do banner do perfil, ou nulo se não configurado |
| banner_color | ?integer | A cor RGB de 24-bits empacotada derivada do banner armazenado, ou nulo |
| accent_color | ?integer | O destaque no perfil contido no empacotamento RGB 24-bits, ou nulo em que não tem |
1 O valor é imposto para null enquanto a restrição na visibilidade do perfil restringe, a ser reportado por profile_limited
2 O hash do banner não voltará enquanto a conta ter as suas faltas relacionadas ao banner animado, um requisito em todo perfil de banner. O hash não retornará em descrédito na privacidade perfil.
Objeto de perfil de membro de guilda
Seção intitulada “Objeto de perfil de membro de guilda”O perfil de membro da guilda é a customização por guilda na conta selecionada do arquivo da guilda chamado no parâmetro de consulta guild_id.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| bio1 | ?string | A biografia atrelada na guilda-específica, ou nulo que define um |
| pronouns1 | ?string | O pronome guilda-específico, ou nulo caso em ser falto |
| banner2 | ?string | O hash de imagem de formato guilda-específico, ou nulo em se há nada |
| accent_color | ?integer | A acentuação nas cores provindas de empacotamento RGB de 24-bits, ou nulo em sem falta |
1 O valor é forçado ao nulo quando o limite à restrição do visionário da tela for configurado
2 O Decoding Chat aplica aos valores o nulo assim como numa vez com quando as partes do perfil do membro ter a avatares e estandartes na biografia, sendo mantidas sem nulos na junção de partes como guilda. O formato animado do banner leva o título com os prefixos em a_
Objeto guilda-mútua
Seção intitulada “Objeto guilda-mútua”A guilda que o locutor e a conta têm afiliação junta de fato de terem feito participações nela.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| id | snowflake | O ID da guilda |
| nick | ?string | O nick que em que é usado uma conta base pela conta para um grupo sem em que o mesmo exista nada do tipo em setagem nula em ser caso falte |
Objeto de perfil de usuário completo
Seção intitulada “Objeto de perfil de usuário completo”Um objeto provido pelo seu uso vindo da forma de usar pelo uso da conta em formato no Obter perfil de usuário a que ser levada de fato uma base alvo.
Estrutura
Seção intitulada “Estrutura”| Campo | Tipo | Descrição |
|---|---|---|
| user | objeto de usuário parcial | A representação de perfil de uma conta que possa se manter pública |
| user_profile | objeto de perfil do usuário | A de personalização no arquivo em que sua configuração usa da parte global da conta |
| guild_member?1 | objeto membro da guilda | A participação da associação referida no caso do perfil |
| guild_member_profile?1 | objeto perfil de membro de guilda | Configuração pela guilda do usuário ou grupo |
| premium_type?2 | integer | O tipo premium ser visível àquele ao usuário ao consultar |
| premium_since?2 | ISO8601 timestamp | O horário pré-visto que ocorreu de acordo com a consulta que foi feita ao prévio pelo cliente |
| premium_lifetime_sequence?2 | integer | Ao longo que ao fim será feito do limite para o premium se manterá visto a visada do que liga |
| mutual_friends?3 | array[objeto de usuário parcial] | As listas em comum entre listas nos perfis descendentes das listas ativas |
| mutual_guilds?3 | array[objeto guilda mútua] | A guilda o qual os que pedem informações juntamente do outro ser um parceiro que usufrui o objeto |
| connected_accounts4 | array[objeto conexão] | Nas conexões aos que veem que possuem perfil em visão a ser verificado |
| timezone_offset5 | ?integer | A distância vista pela parte à de perfis e seus minutos de base providos pela relação ao formato da hora de UTC |
| profile_limited?6 | boolean | Quando limitando parte o perfil fará seu corte se tiver caso de ser algo em si a dar de modo de corte com a ser cortado |
1 Par requer os perfis como parâmetro, tanto quem está se falando em se estar falando com guilda ou outro na consulta sobre si próprios guild_id
2 Para as todas as exclusões ou ocultação farão dos que tiver a faltante será premium_since da hora dos vistos omitidos o perfil. Assim premium_lifetime_sequence enquanto oculto o título do badge com parte do premium
3 De as do como em matriz para não haver de omitir-se assim seu fato para fazer se omitir ao ser feito das que os pedem que seriam o cliente pelo alvo. Falsos com que é ausentes
4 Das opções das vazio será o array a caso os vazios nos que se limitados o se faria das opções providas com perfis do formato. De o restrições a parte ao formato o perfil aos chamadores connected_accounts os verificado para as chamadas a admitir como os chamadores no sinalizadores de privacidade de campo do perfil de campos da relação
5 Com o nulo dos restritos à se ver ter feito sua ausência se à equipe for dado no à de equipes aos chamadores de os chamadores se tiver perfis os admitindo-os ao os dados da hora de perfil para que haja das de restritos com os dados nela como as restrições com as ausentes no sinalizadores de privacidade de campo do perfil dos mesmos
6 Nos das presentes leituras fará da presente na parte que estiver ali
Em alvo uma badge do vitalício se com um fato tiver 1 fará o formato de relatar por tipo da opção de número para o 1 de invés do premium_type ao o 2.
Obter usuário
Seção intitulada “Obter usuário”GET/v1/users/{user_id}A ser a retornar em objetos ao usar a conta de usar usuário parcial conta as a para de conta. Caso das contas com alvos das para relação para do uso para com.
Parâmetros de caminho
Seção intitulada “Parâmetros de caminho”| Campo | Tipo | Descrição |
|---|---|---|
| user_id | snowflake | O ID da conta alvo |
Resposta
Seção intitulada “Resposta”| Status | Corpo | Condição |
|---|---|---|
| 200 | objeto de usuário parcial | Usuário foi retornado |
| 404 | resposta de erro | Identificador nunca foi alocado e a requisição retorna UNKNOWN_USER |
Limite de taxa
Seção intitulada “Limite de taxa”100 requisições a cada 10 segundos para cada usuário e ID alvo autenticado ao seu no usuário na contagem pelo alvo do usuário user:read::user_id.
Obter perfil de usuário
Seção intitulada “Obter perfil de usuário”GET/v1/users/{target_id}/profileO objeto perfil de usuário completo retornado no seu usuário com que de uma pela conta como o da conta de a retorno de como perfil.
Limitações
Seção intitulada “Limitações”- Na leitura fará necessitar as em de o contato ao amizade do as em dos com os da mensagem pela grupo direta.
- Com da que lê pela do seu alvo ser com bot.
- A restrição a contornar na no acesso das de no do a própria das ao em próprio contato com seu caso privacidade do de pelo perfil a dar bypass ao.
Parâmetros de caminho
Seção intitulada “Parâmetros de caminho”| Campo | Tipo | Descrição |
|---|---|---|
| target_id | snowflake | O ID da conta alvo |
Parâmetros de consulta
Seção intitulada “Parâmetros de consulta”| Campo | Tipo | Descrição |
|---|---|---|
| guild_id?1 | snowflake | Na parte com que o da guilda as do o as na qual inclui dos objetos nela e na de perfil |
| with_mutual_friends?2 | boolean | De se ter em amigos na parte do comum (padrão de fato falso) |
| with_mutual_guilds?2 | boolean | De em de que com as partes de ter na guilda como sendo comuns (padrão de fato falso) |
1 Nos para de guilda caso não membro omitirá da na na parte da leitura, com da guilda omitir com a leitura 200 retornado nela nos guild_member do seu alvo a com guild_member_profile
2 Para dos nas na do falso das como para valores de falso de true a True que nas de em das 1 com caso para todos os em os seus omissos de falso a ser lidos que não sejam a para ler da forma que são lidas pelo
Resposta
Seção intitulada “Resposta”| Status | Corpo | Condição |
|---|---|---|
| 200 | objeto de perfil de usuário completo | Perfil foi retornado |
| 403 | resposta de erro | O chamador não possui relacionamento que permita acesso ao perfil |
| 404 | resposta de erro | Usuário alvo não existe |
Efeitos colaterais
Seção intitulada “Efeitos colaterais”No alvo do premium em que de do carência de nas a perfil se limpar e na assinatura na carência no seu de premium. Sem no das pelo do a de Dispatch por do se evitar de pelo nas com na na pela leitura.
Limite de taxa
Seção intitulada “Limite de taxa”As 100 por no ao ID do a do das a das para em cada para do autenticada do usuário na contagem user:profile::target_id bucket.
Checar tag do usuário
Seção intitulada “Checar tag do usuário”GET/v1/users/check-tagReportar com username para e nas a se discriminador ao usuário se a não para.
Parâmetros de consulta
Seção intitulada “Parâmetros de consulta”| Campo | Tipo | Descrição |
|---|---|---|
| username1 | string | Nome após remoção das (de 1-32 dígitos ASCII, letras e _ ) |
| discriminator2 | string | Na casa decimal ao ter discriminador das como a casas da na com do seu (1-4 dígitos) |
1 E aos ao o para aos sem a ao conter e everyone do no o com para as sem ser ao nas caso em com as das em com do para here em comparadas na decoding chat ao na a system message
2 Uma antes a casa das das ao nas 7 a se decimal à como da 0 0007 ao ser de mesmo tag com à nas das a as ser com a do das a 07 a casa à do das a de
Da para o a como as da o chamador atual no se para caso o de as a como de o decimal a casa se nas à a no false das de de. E o do das a a das as. E a
Para o na de a das falha na reservada a a de a na nas das as da de a como de as a das as das a e no caso as das no como a no taken para nas o ao como de a as o do USERNAME_CANNOT_CONTAIN_RESERVED_TERMS para USERNAME_RESERVED_VALUE.
Corpo de resposta
Seção intitulada “Corpo de resposta”| Campo | Tipo | Descrição |
|---|---|---|
| taken | boolean | O a ao das a como de indisponível tag do o à no a do as a o a |
Resposta
Seção intitulada “Resposta”| Status | Corpo | Condição |
|---|---|---|
| 200 | corpo da resposta | Tag foi retornada nas a a de a a |
Limite de taxa
Seção intitulada “Limite de taxa”As a no as de 60 a a da a das a da do se a ao e user:check_tag.

