Documentos de API

Obtener grupos de usuarios

Obtiene información de los grupos a los que pertenece un usuario.

MétodoGET
URLhttps://{subdomain}.kintone.com/v1/user/groups.json
Autenticación Autenticación mediante token API , Autenticación mediante contraseña , Autenticación mediante sesión
Content-Typeno es necesario (si se incluyen parámetros en el cuerpo de la solicitud, use application/json)

Contenido

Permisos

Todos los usuarios que no sean usuarios invitados pueden usar esta API.

Parámetros de solicitud

Parámetro Tipo Obligatorio Descripción
code Cuerda Sí El código del usuario (nombre de inicio de sesión).

Solicitud de muestra

JavaScript using kintone.api() 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

var body = {
  'code': 'sample_user_code'
};
kintone.api(kintone.api.url('/v1/user/groups.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

XMLHttpRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

var params = '?code=sample_user_code';
var url = 'https://{subdomain}.kintone.com/v1/user/groups.json' + params;
console.log(url);
var xhr = new XMLHttpRequest();
xhr.open('GET', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send();

Parámetros de respuesta

Parámetro Tipo Descripción
groups Arreglo Una lista de grupos a los que pertenece el usuario, como tipos de grupo.
Para obtener más información sobre los tipos de grupo, consulte la siguiente documentación:
Tipo de grupo

Ejemplo de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
  "groups": [
    {
      "id": "1",
      "code": "g1",
      "name": "Development Group",
      "description": ""
    },
    {
      "id": "7532782697181632513",
      "code": "everyone",
      "name": "Everyone",
      "description": null
    }
  ]
}