Documentos de API

Actualizar códigos de usuario

Actualiza los códigos de usuario de los usuarios.

MétodoPUT
URLhttps://{subdomain}.kintone.com/v1/users/codes.json
Autenticación Autenticación de contraseña , Autenticación de sesión
Content-Typeapplication/json

Contenido

Permisos

Solo los administradores pueden usar esta API.

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

Parámetros de solicitud

En la solicitud se debe especificar una matriz de "códigos" que consiste en un objeto formado por las siguientes propiedades. Se pueden actualizar códigos de usuario de hasta 100 usuarios.

Parámetro Valor Obligatorio Descripción
currentCode Cuerda Sí El código de usuario actual (nombre de inicio de sesión).
El límite máximo es de 128 caracteres.
No se permiten valores que consten solo de espacios en blanco o nulos.
newCode Cuerda Sí El nuevo código de usuario (nombre de inicio de sesión).
El límite máximo es de 128 caracteres.
No se permiten valores que consten solo de espacios en blanco o nulos.

Solicitud de muestra

JavaScript using kintone.api() 

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

var body = {
  'codes': [
    {
      'currentCode': 'user1',
      'newCode': 'user1-new'
    },
    {
      'currentCode': 'user2',
      'newCode': 'user2-new'
    }
  ]
};
kintone.api(kintone.api.url('/v1/users/codes.json', true), 'PUT', 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
17
18
19
20
21
22
23
24
25
26
27
28
29
30

var body = {
  'codes': [
    {
      'currentCode': 'user1',
      'newCode': 'user1-new'
    },
    {
      'currentCode': 'user2',
      'newCode': 'user2-new'
    }
  ],
  // CSRF TOKEN: Needs to be set when using API (POST, PUT, DELETE) from Kintone
  '__REQUEST_TOKEN__': kintone.getRequestToken()
};

var url = 'https://{subdomain}.kintone.com/v1/users/codes.json';
var xhr = new XMLHttpRequest();
xhr.open('PUT', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send(JSON.stringify(body));

Parámetros de respuesta

Se devolverá un objeto JSON vacío.

Ejemplo de respuesta 

1

{}

Limitaciones

  • No se recomienda ejecutar esta API mientras se realizan las siguientes operaciones en el Administración de usuarios y sistemas página:
    • Actualizaciones para los usuarios en el Departamentos y Usuarios página
      Para obtener más información sobre Departamentos y usuarios, consulte el siguiente artículo:
      Gestión de usuarios (External link)
    • Importar desde un archivo