Documentos de API

Obtener departamentos

Obtiene información de los departamentos.

MétodoGET
URLhttps://{subdomain}.kintone.com/v1/organizations.json
Autenticación Autenticación de contraseña, Autenticación de 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.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
ids Arreglo Opcional Una lista de identificadores de departamento, como tipos de identificación.
Se pueden especificar hasta 100 identificadores.
Para obtener más información sobre los tipos de identificación, consulte el siguiente enlace:
Tipo de ID
codes Arreglo Opcional Una lista de códigos de departamento, como cadenas.
Se pueden especificar hasta 100 códigos.
offset Integer Opcional La compensación.
Si se omite, este valor es 0.
size Integer Opcional El número máximo de información del Departamento que se va a obtener.
Si se omite, este valor es 100.

*Si ids y codes se ignoran, se responderán hasta 100 identificadores en orden ascendente de identificación.

**Si ids y codes están ambos configurados, se devolverá un error. Solo se puede configurar uno.

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/organizations.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/organizations.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
organizations Arreglo Una lista de información de departamento, como tipos de organización, en orden ascendente de id.
Para obtener más información sobre los tipos de organización, consulte el siguiente enlace:
Tipo de organización

Ejemplo de respuesta 

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

{
  "organizationTitles": [
    {
      "organization": {
        "code": "B",
        "description": "sample description",
        "id": "2",
        "localName": "sample localName",
        "localNameLocale": "en",
        "name": "Organization B",
        "parentCode": "A"
      },
      "title": {
        "code": "leader",
        "description": "leader",
        "id": "1",
        "name": "leader"
      }
    }
  ]
}