GET | Recuperar grupo específico

Prev Next

Endpoint: GET {{scim_base_url}}/Groups/{{group_id}}

Descrição: Recupera informações detalhadas de um grupo específico identificado pelo seu ID único, incluindo lista completa de membros e propriedades do grupo.

Parâmetros da Requisição

  • Método: GET.
  • Parâmetro de Caminho: group_id (obrigatório).
    • Identificador único do grupo alvo.
  • Content-Type: application/json.
  • Authorization: Token Bearer obrigatório.

Estrutura da Resposta

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
  "id": "string",
  "displayName": "string",
  "description": "string",
  "members": [
    {
      "type": "User",
      "value": "string",
      "primary": boolean
    }
  ]
}

Elementos da Resposta

Elemento Descrição
schemas Identificador do schema SCIM para recurso de grupo.
id Identificador único do grupo.
displayName Nome legível do grupo.
description Descrição opcional do grupo.
members Array de membros do grupo com tipo e indicadores de prioridade.

Códigos de Status

Código de Status Descrição
200 OK Recuperação bem-sucedida das informações do grupo.
404 Not Found Grupo com o ID especificado não existe.
401 Unauthorized Token de autenticação inválido ou ausente.
403 Forbidden Permissões insuficientes para acessar o grupo.