Agregar registros

Documentos de API

Agregar registros

Agrega varios registros a una aplicación.

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

Permisos

Se necesita permiso para agregar registros a la aplicación.
Se necesita permiso para editar los campos que se incluyen en los parámetros de solicitud.

Parámetros de solicitud

PARÁMETRO	VALOR	OBLIGATORIO	DESCRIPCIÓN
app	Integer	Sí	El identificador de la aplicación.
records	Matriz de objetos	Sí	Contiene una matriz de objetos de registro, que contiene códigos de campo y sus valores. Los campos que no están incluidos en los objetos se agregan con su valor predeterminado. Los objetos que contienen códigos de campo que no existen se ignoran. Para obtener más información sobre los tipos de campo, consulte el siguiente artículo: Tipos de campo

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
27
28
29


var body = {
  'app': 1,
  'records': [
    {
      'Text': {
        'value': 'Sample001'
      },
      'Number': {
        'value': 1
      }
    },
    {
      'Text': {
        'value': 'Sample002'
      },
      'Number': {
        'value': 2
      }
    }
  ]
};

kintone.api(kintone.api.url('/k/v1/records.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
23
24


$ curl -X POST 'https://{subdomain}.kintone.com/k/v1/records.json' \
-H 'X-Cybozu-API-Token: {APIToken}' \
-H 'Content-Type: application/json' \
-d '{
  "app": 1,
  "records": [
    {
      "Text": {
        "value": "Sample001"
      },
      "Number": {
        "value": 1
      }
    },
    {
      "Text": {
        "value": "Sample002"
      },
      "Number": {
        "value": 2
      }
    },
  ]
}'

Parámetros de respuesta

Parámetro	Tipo	Descripción
ids	Matriz de cadenas	Los identificadores de registro de los registros creados.
revisions	Matriz de cadenas	Los números de revisión de los registros.

Ejemplo de respuesta

1
2
3
4


{
  "ids": ["77", "78"],
  "revisions": ["1", "1"]
}

Limitaciones

Para agregar valores a los siguientes campos, debe ser el administrador de la aplicación:

Creado por
Actualizado por
Fecha y hora creada
Fecha y hora actualizada

Si hay campos con la opción "Campo obligatorio" activada, esos campos deben incluirse en la solicitud.
Los valores no se pueden agregar a los siguientes campos.

Los destinos de asignaciones de campos del campo Búsqueda
Estado
Categorías
Calculado
Cesionario

Para conocer otras limitaciones, consulte la sección Limitaciones del siguiente artículo:
Descripción general de la API REST de Kintone