Agregar aplicación de vista previa

Documentos de API

Agregar aplicación de vista previa

Crea una aplicación de vista previa. Esta API actualiza la configuración previa a la puesta en marcha. Después de usar esta API, use la siguiente API para implementar la configuración en la aplicación activa:
Implementar la configuración de la aplicación

Método	POST
URL	https://{subdomain}.kintone.com/k/v1/preview/app.json
URL (espacio de invitado)	https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app.json
Autenticación	Autenticación de contraseña, Autenticación de sesión
Content-Type	application/json

Permisos

Se necesita permiso para crear aplicaciones en el grupo de aplicaciones predeterminado.
Los tokens de API no se pueden usar con esta API.

Parámetros de solicitud

Parámetro	Valor	Obligatorio	Descripción
name	Cuerda	Obligatorio	El nombre de la aplicación. La longitud máxima es de 64 caracteres.
space	Integer		El ID de espacio donde se creará la aplicación.
thread	Integer		El identificador de subproceso del subproceso en el espacio donde se creará la aplicación. *Se recomienda omitir este parámetro para que las aplicaciones se creen en el subproceso predeterminado. Actualmente no hay ninguna razón útil para crear aplicaciones en subprocesos que no sean el subproceso predeterminado, ya que no hay representaciones visuales en Kintone de aplicaciones relacionadas con subprocesos. Solo hay representaciones visuales de las aplicaciones relacionadas con los espacios.

Los siguientes campos se crean automáticamente con la aplicación de vista previa. Estos campos se crearán en el idioma establecido en la configuración de usuario del usuario de Kintone utilizado en la autenticación.

Número de registro
Creado por
Actualizado por
Fecha y hora creada
Fecha y hora actualizada
Status
Cesionario
Categoría

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

JavaScript using kintone.api()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


var body = {
  'name': 'APP_NAME',
  'space': 10,
  'thread': 11
};

kintone.api(kintone.api.url('/k/v1/preview/app.json', true), 'POST', 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


var body = {
  'name': 'APP_NAME',
  'space': 10,
  'thread': 11,
  // CSRF TOKEN: used for all APIs that have an HTTP method of POST, PUT and DELETE on Kintone.
  '__REQUEST_TOKEN__': kintone.getRequestToken()
};

var url = 'https://{subdomain}.kintone.com/k/v1/preview/app.json';
var xhr = new XMLHttpRequest();
xhr.open('POST', 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

Parámetro	Tipo	Descripción
app	Cuerda	El identificador de aplicación de la aplicación de vista previa creada.
revision	Cuerda	El número de revisión de la configuración de la aplicación.

Ejemplo de respuesta

1
2
3
4


{
  "app": "23",
  "revision": "1"
}