Agregar departamentos

Documentos de API

Agregar departamentos

Agrega departamentos a un entorno de Kintone.

Método	POST
URL	https://{subdomain}.kintone.com/v1/organizations.json
Autenticación	Autenticación mediante token API , Autenticación mediante contraseña , Autenticación mediante sesión
Content-Type	application/json

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

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
organizations	Matriz de objetos	Sí	Una matriz de objetos organizations, que contienen los datos de los departamentos que se van a agregar. Se pueden especificar hasta 100 objetos organizations.
organizations[].code	Cadena	Sí	El código del departamento. El límite máximo es de 128 caracteres.
organizations[].name	Cadena	Sí	El nuevo nombre del departamento. El límite máximo es de 128 caracteres.
organizations[].localName	Cadena	Opcional	El nombre local del departamento. El límite máximo es de 128 caracteres.
organizations[].localNameLocale	Cadena	Opcional	La configuración regional del nombre local. `en`: Inglés `ja`: Japonés `zh`: Chino (simplificado) `zh-TW`: Chino (tradicional) `es`: Español `pt-BR`: Portugués de Brasil `th`: Tailandés
organizations[].parentCode	Cadena	Opcional	El código del departamento padre.
organizations[].description	Cadena	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 padre indicado en el parámetro 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 padre antes que los del departamento hijo.