Todos os produtos
Search
Central de documentação

Identity as a Service:GetUser

Última atualização: Jun 28, 2026

Obtém os detalhes de uma conta do Employee Identity and Access Management (EIAM).

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

GET /v2/{instanceId}/{applicationId}/users/{userId} HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

instanceId

string

Sim

O ID da instância.

idaas_ue2jvisn35ea5lmthk267xxxxx

applicationId

string

Sim

O ID da aplicação.

app_mkv7rgt4d7i4u7zqtzev2mxxxx

userId

string

Sim

O ID da conta.

user_d6sbsuumeta4h66ec3il7yxxxx

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Authorization

string

Sim

As informações de autenticação. O valor está no formato Bearer ${access_token}. Exemplo: Bearer ATxxxx.

Bearer AT8csE2seYxxxxxij

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

instanceId

string

O ID da instância.

idaas_ue2jvisn35ea5lmthk267xxxxx

organizationalUnits

array<object>

As unidades organizacionais às quais a conta pertence.

object

A unidade organizacional.

organizationalUnitId

string

O ID da unidade organizacional.

ou_wovwffm62xifdziem7an7xxxxx

organizationalUnitName

string

O nome da unidade organizacional.

name001

primary

boolean

Indica se a unidade organizacional é a unidade organizacional principal.

true

primaryOrganizationalUnitId

string

O ID da unidade organizacional principal da conta.

ou_wovwffm62xifdziem7an7xxxxx

customFields

array<object>

Os campos estendidos da conta.

object

fieldName

string

O nome do campo estendido.

xxxx

fieldValue

string

O valor do campo estendido. Os valores dos campos são retornados como strings, independentemente dos tipos de dados dos campos. Por exemplo, true ou false é retornado para um campo booleano.

字段数据值

userId

string

O ID da conta.

user_d6sbsuumeta4h66ec3il7yxxxx

username

string

O nome de usuário da conta.

name001

displayName

string

O nome de exibição da conta.

display_name001

passwordSet

boolean

Indica se a senha está definida.

true

phoneRegion

string

O código do país do número de celular. Por exemplo, o código do país da China é 86, sem 00 ou +.

86

phoneNumber

string

O número de celular do usuário proprietário da conta.

156xxxxxxx

phoneNumberVerified

boolean

Indica se o número de celular foi verificado. Um valor true indica que o número de celular foi verificado pelo usuário ou definido com o status de verificado pelo administrador. Um valor false indica que o número de celular não foi verificado.

true

email

string

O endereço de e-mail do usuário.

example@example.com

emailVerified

boolean

Indica se o endereço de e-mail foi verificado. Um valor true indica que o endereço de e-mail foi verificado pelo usuário ou definido com o status de verificado pelo administrador. Um valor false indica que o endereço de e-mail não foi verificado.

true

userExternalId

string

O ID externo da conta. O ID externo pode ser usado para mapear dados externos para os dados da conta no EIAM do Identity as a Service (IDaaS). Por padrão, o ID externo é o ID da conta.\n\nNota: Para contas com o mesmo tipo de origem e ID de origem, cada conta possui um ID externo exclusivo.

user_d6sbsuumeta4h66ec3il7yxxxx

userSourceType

string

O tipo de origem da conta. Valores válidos:\n\n- build_in: A conta foi criada no IDaaS.\n\n- ding_talk: A conta foi importada do DingTalk.\n\n- ad: A conta foi importada do Microsoft Active Directory (AD).\n\n- ldap: A conta foi importada de um serviço Lightweight Directory Access Protocol (LDAP).

build_in

userSourceId

string

O ID de origem da conta.\n\nSe a conta foi criada no IDaaS, seu ID de origem é o ID da instância do IDaaS. Se a conta foi importada, seu ID de origem é o ID da empresa na origem. Por exemplo, se a conta foi importada do DingTalk, seu ID de origem é o valor corpId da empresa no DingTalk.

idaas_ue2jvisn35ea5lmthk267xxxxx

status

string

O status da conta. Valores válidos: enabled e disabled.

enabled

accountExpireTime

integer

A hora em que a conta expira. Este valor é um carimbo de data e hora UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.

1652085686179

registerTime

integer

A hora em que a conta foi registrada. Este valor é um carimbo de data e hora UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.

1652085686179

lockExpireTime

integer

A hora em que o bloqueio da conta expira. Este valor é um carimbo de data e hora UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.

1652085686179

createTime

integer

A hora em que a conta foi criada. Este valor é um carimbo de data e hora UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.

1652085686179

updateTime

integer

A hora em que a conta foi modificada pela última vez. Este valor é um carimbo de data e hora UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.

1652085686179

description

string

A descrição da conta.

测试账户

groups

array<object>

Os grupos aos quais a conta pertence.

object

As informações sobre o grupo ao qual a conta pertence.

groupId

string

O ID do grupo.

group_ufdsasn35ea5lmthk267xxxxx

groupName

string

O nome do grupo.

name_test

description

string

A descrição do grupo.

description_demo

Exemplos

Resposta de sucesso

JSON formato

{
  "instanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
  "organizationalUnits": [
    {
      "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx",
      "organizationalUnitName": "name001",
      "primary": true
    }
  ],
  "primaryOrganizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx",
  "customFields": [
    {
      "fieldName": "xxxx",
      "fieldValue": "字段数据值"
    }
  ],
  "userId": "user_d6sbsuumeta4h66ec3il7yxxxx",
  "username": "name001",
  "displayName": "display_name001",
  "passwordSet": true,
  "phoneRegion": "86",
  "phoneNumber": "156xxxxxxx",
  "phoneNumberVerified": true,
  "email": "example@example.com",
  "emailVerified": true,
  "userExternalId": "user_d6sbsuumeta4h66ec3il7yxxxx",
  "userSourceType": "build_in",
  "userSourceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
  "status": "enabled",
  "accountExpireTime": 1652085686179,
  "registerTime": 1652085686179,
  "lockExpireTime": 1652085686179,
  "createTime": 1652085686179,
  "updateTime": 1652085686179,
  "description": "测试账户",
  "groups": [
    {
      "groupId": "group_ufdsasn35ea5lmthk267xxxxx",
      "groupName": "name_test",
      "description": "description_demo"
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.