Obtiene la descripción, el nombre, el icono, la revisión y el tema de color de una aplicación.
Ajustes previos a la transmisión en vivo
Es posible que las aplicaciones contengan configuraciones previas a la transmisión en vivo que aún no se han implementado en la aplicación en vivo.
Acceda a la configuración previa a la transmisión en vivo con la siguiente URL.
URL |
https://{subdomain}.kintone.com/k/v1/preview/app/settings.json |
URL (espacio de invitado) |
https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/settings.json |
Permisos
- Se necesita permiso para ver registros o agregar registros al obtener datos de aplicaciones activas.
- Los permisos de administración de aplicaciones son necesarios para obtener datos de la configuración previa a la transmisión.
Parámetros de solicitud
Parámetro |
Valor |
Obligatorio |
Descripción |
app |
Entero o cuerda |
Obligatorio |
El identificador de la aplicación. |
lang |
Cuerda |
|
El idioma localizado en el que se recuperarán los datos:default : recupera los nombres predeterminadosen : recupera los nombres localizados en inglészh : recupera los nombres chinos localizadosja : recupera los nombres japoneses localizadosuser : recupera los nombres localizados en el mismo idioma que la configuración de idioma** establecida en el usuario utilizado para la autenticación. Si se ignora, se recuperarán los nombres predeterminados.
|
**Si la configuración de idioma del usuario se establece en Usar la configuración del navegador web, se utilizará la configuración establecida en el encabezado Accept-Language. Si no hay ningún encabezado Accept-Language, el idioma establecido en el Localización en el menú del administrador del sistema.
Solicitud de muestra
1
2
3
4
5
6
7
8
9
10
11
12
|
var body = {
'app': 1,
'lang': 'en'
};
kintone.api(kintone.api.url('/k/v1/app/settings.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 = '?app=1&lang=en';
var url = 'https://{subdomain}.kintone.com/k/v1/app/settings.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 |
name |
Cuerda |
El nombre de la aplicación. |
description |
Cuerda |
La descripción de la aplicación en formato HTML. |
icon |
Objecto |
Objeto que contiene datos del icono de la aplicación. |
icon.file |
Objecto |
Objeto que contiene datos de archivos de iconos cargados. |
icon.file.contentType |
Cuerda |
El tipo MIME del archivo de icono cargado. |
icon.file.fileKey |
Cuerda |
fileKey del archivo de icono cargado. |
icon.file.name |
Cuerda |
El nombre del archivo de icono cargado. |
icon.file.size |
Cuerda |
El tamaño de bytes del archivo de icono cargado. |
icon.key |
Cuerda |
El identificador de clave del icono. Respondió, si se utilizan los iconos preestablecidos dentro de Kintone. |
icon.type |
Cuerda |
El tipo de icono:FILE : Una imagen cargada.PRESET : Un icono preestablecido dentro de Kintone.
|
theme |
Cuerda |
El tema del color.WHITE RED BLUE GREEN YELLOW BLACK Las aplicaciones creadas antes de febrero de 2017 pueden responder con los siguientes temas clásicos:CLIPBOARD, BINDER, PENCIL, CLIPS.
|
titleField |
Objecto |
El título del registro. |
titleField.selectionMode |
Cuerda |
La opción de El campo que se va a utilizar como título del registro Configuración.AUTO : El Establecer automáticamente opción.MANUAL : El Ajuste manual opción.
|
titleField.code |
Cuerda |
El código de campo del campo utilizado como título del registro. |
enableThumbnails |
Booleano |
El Mostrar miniaturas ajuste. |
enableBulkDeletion |
Booleano |
El Habilitar la eliminación masiva de registros ajuste. |
enableComments |
Booleano |
El Habilitar comentarios ajuste. |
enableDuplicateRecord |
Booleano |
El Habilite la función para "duplicar registro" ajuste. |
numberPrecision |
Objecto |
El recisión de números y cálculos ajuste. |
numberPrecision.digits |
Cuerda |
El Número total de dígitos ajuste. |
numberPrecision.decimalPlaces |
Cuerda |
El Número de decimales para redondear ajuste. |
numberPrecision.roundingMode |
Cuerda |
El Redondeo ajusteHALF_EVEN : Redondear al número par más cercanoUP : RodearDOWN : Redondear hacia abajo
|
firstMonthOfFiscalYear |
Cuerda |
El Primer mes del año fiscal ajuste. Se devolverá el número del mes. |
revision |
Cuerda |
El número de revisión de la configuración de la aplicació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
22
23
24
|
{
"name": "San Francisco Lunch Map",
"description": "A list of great places to go!",
"icon": {
"type": "PRESET",
"key": "APP60"
},
"theme": "WHITE",
"titleField": {
"selectionMode": "MANUAL",
"code": "RecordNumber"
},
"enableThumbnails": true,
"enableBulkDeletion": true,
"enableComments": true,
"enableDuplicateRecord": true,
"numberPrecision": {
"digits": "16",
"decimalPlaces": "4",
"roundingMode": "HALF_EVEN"
},
"firstMonthOfFiscalYear": "4",
"revision": "24"
}
|