Documentos de API

Obtener servicios de usuario

Obtiene los servicios que los usuarios utilizan en el entorno de Kintone.

MétodoGET
URLhttps://{subdomain}.kintone.com/v1/users/services.json
Autenticación Autenticación mediante token API , Autenticación mediante contraseña , Autenticación mediante sesión
Content-Typeapplication/json (no es necesario si se especifica la consulta con una cadena de consulta)

Contenido

Permisos

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

Para obtener más información sobre los usuarios invitados, consulte el siguiente artículo:
Gestión de invitados (External link)

Parámetros de solicitud

Parámetro Tipo Obligatorio Descripción
codes Matriz de cadenas Opcional La lista de los códigos de usuario de destino.
La longitud máxima de la matriz es 100.
Si se ignora este parámetro, se dirigirá a todos los usuarios.
offset Integer Opcional La compensación.
Si se ignora este parámetro, se establecerá 0.
size Integer Opcional El tamaño máximo de la matriz en la respuesta.
Se puede especificar de 1 a 100.
Si se ignora este parámetro, se establecerá 100.

Solicitud de muestra

JavaScript using kintone.api() 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

var body = {
  'codes': ['user1', 'user2', 'user3'],
  'offset': 0,
  'size': 2
};
kintone.api(kintone.api.url('/v1/users/services.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

Parámetros de respuesta

Parámetro Tipo Descripción
users Matriz de objetos Matriz que consta de códigos de usuario y sus servicios relacionados.
Los objetos se enumeran en orden de identificación del usuario.
users.code Cuerda El código del usuario.
users.services Matriz de cadenas Los servicios utilizados por el usuario.
Los usuarios que usen Kintone tendrán la cadena "kintone" devuelto en la matriz.
Si el usuario no utiliza ningún servicio, se devolverá una matriz vacía.

Ejemplo de respuesta

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

{
  "users": [
    {
      "code": "user1",
      "services": ["kintone"]
    },
    {
      "code": "user2",
      "services": []
    },
    {
      "code": "user3",
      "services": ["kintone"]
    }
  ]
}

Limitaciones

  • El usuario "Administrador" no se incluirá en la respuesta.