Documentos de API

Agregar registro

Agrega 1 registro a una aplicación.

MétodoPOST
URLhttps://{subdomain}.kintone.com/k/v1/record.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/record.json
Autenticación Autenticación de contraseña , Autenticación de token de API , Autenticación de sesión
Content-Typeapplication/json

Contenido

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.
  • Se necesita permiso para editar los campos que se incluyen en los parámetros de solicitud.

Parámetros de solicitud

Parámetro Tipo Obligatorio Descripción
app Integer Sí El identificador de la aplicación.
record Objeto Opcional Los códigos de campo y los valores se especifican en este objeto.
Los valores que se pueden especificar varían en función del tipo de campo.
Si se ignora, el registro se agregará con los valores de campo predeterminados.
Si se especifican códigos de campo que no existen, se omitirán.
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

var body = {
  'app': 1,
  'record': {
    'Text': {
      'value': 'Sample'
    },
    'Number': {
      'value': 1
    }
  }
};

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

curl -X POST 'https://{subdomain}.kintone.com/k/v1/record.json' \
  -H 'X-Cybozu-API-Token: {APIToken}' \
  -H 'Content-Type: application/json' \
  -d '{
    "app": 1,
    "record": {
      "text": {
        "value": "Sample"
      },
      "Number": {
        "value": 1
      }
    }
  }'

Parámetros de respuesta

Parámetro Tipo Descripción
id Cuerda El ID de registro del registro creado.
revision Cuerda El número de revisión del Registro.

Ejemplo de respuesta

1
2
3
4

{
  "id": "1",
  "revision": "1"
}

Limitaciones

Se necesita permiso para administrar la aplicación para agregar valores a los siguientes campos:

  • 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.

No se pueden agregar valores a los siguientes campos:

  • Los destinos de asignaciones de campos del campo Búsqueda
  • Estado
  • Categorías
  • Calculado
  • Cesionario
  • Campos de texto con la opción "Calcular automáticamente"

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

Agregar varios registros

Para agregar datos de varios registros, consulte el siguiente artículo:
Agregar registros