Documentos de API

Agregar departamentos

Agrega departamentos a un entorno de Kintone.

MétodoPOST
URLhttps://{subdomain}.kintone.com/v1/organizations.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

Parámetro Valor Obligatorio Descripción
organizations Matriz de objetos Sí Una matriz de Organizaciones objetos, que contienen los datos de los Departamentos que se van a añadir.
Hasta 100 Organizaciones Se pueden especificar objetos.
organizations[].code Cuerda Sí El Código de Departamento.
El límite máximo es de 128 caracteres.
organizations[].name Cuerda Sí El nuevo nombre del departamento.
El límite máximo es de 128 caracteres.
organizations[].localName Cuerda Opcional El nombre local del departamento.
El límite máximo es de 128 caracteres.
organizations[].localNameLocale Cuerda Opcional Configuración regional del nombre local.
en, ja, zho es se puede especificar.
organizations[].parentCode Cuerda Opcional El Código del Departamento matriz.
organizations[].description Cuerda Opcional La descripción del departamento.
El límite máximo es de 1000 caracteres.

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
20
21
22
23
24
25
26

var body = {
  'organizations': [
    {
      'code': 'security',
      'name': 'Department of Internet Security',
      'localName': 'Department of Internet Security',
      'localNameLocale': 'en',
      'description': 'A Department dedicated to the Internet Security of the company.'
    },
    {
      'code': 'database_acquisition',
      'name': 'Department of Database Acquisition',
      'localName': 'Department of Database Acquisition',
      'localNameLocale': 'en',
      'description': 'A Department dedicated to acquiring the most productive databases.'
    }
  ]
};

kintone.api(kintone.api.url('/v1/organizations.json', true), 'POST', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

Muestra de curl 

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

$ curl -X POST \
  https://{subdomain}.kintone.com/v1/organizations.json \
  -H 'Content-Type: application/json' \
  -H 'X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=' \
  -d '{"organizations":
  [
    { 
      "code": "security", 
      "name": "Department of Internet Security", 
      "localName": "Department of Internet Security", 
      "localNameLocale": "en", 
      "description": "A Department dedicated to the Internet Security of the company." 
    }, 
    { 
      "code": "database_acquisition", 
      "name": "Department of Database Acquisition", 
      "localName": "Department of Database Acquisition", 
      "localNameLocale": "en", 
      "description": "A Department dedicated to acquiring the most productive databases." 
    } 
  ]
}'

Ejemplo de respuesta 

1

{}

Limitaciones

  • El Departamento de Padres declaró dentro de la parentCode también puede existir dentro de la matriz de parámetros de solicitud. En este caso, la matriz debe incluir los datos del Departamento Principal antes que los del Departamento Secundario.