Contenido de las notificaciones de webhook activadas por acciones en Kintone

Article Number:040602

La activación Webhooks permite enviar notificaciones desde Kintone en formato JSON.
Las tablas a continuación muestran los parámetros que se utilizan en las notificaciones activadas por cada evento.

Se ha añadido el registro / Registro editado / Se ha cambiado el estado

Parámetro Tipo de datos Descripción
identificación Cadena Indica un ID único que se asigna a cada notificación.
tipo Cadena Indica el tipo de evento.
Se ha añadido el registro: ADD_RECORD
Registro editado: UPDATE_RECORD
El estado Registro ha cambiado: UPDATE_STATUS
aplicación Objeto El objeto que presenta información de la aplicación.
ID de aplicación Cadena Indica el ID de la aplicación.
nombre de la aplicación Cadena Indica el nombre de la aplicación.
registro Objeto El objeto que presenta información de registro.
El formato del objeto es el mismo que el de la API REST para recuperar los detalles de un registro.
Obtener Registro (Kintone Developer Program)
título del registro Cadena Indica el título del registro.
Puede cambiar qué campo se utiliza como título del registro.
Establecer un campo de título
URL Cadena Indica el enlace permanente del registro.

Ejemplo Notificación

{
    "id":"01234567-0123-0123-0123-0123456789ab",
    "type":"ADD_RECORD",
    "app":{
        "id":"1",
        "name":"Lead Management"
        },
    "record":{
        "Record number":{
            "type":"RECORD_NUMBER",
            "value":"2"
        },
        ...(omitted)...
        "$revision":{
            "type":"__REVISION__",
            "value":"3"
            },
        "$id":{
            "type":"__ID__",
            "value":"2"
            }
        },
    "recordTitle":"Visit: Cybozu, Inc.",
    "url":"https://example.cybozu.com/k/1/show#record=2"
}

Se ha eliminado el registro

Parámetro Tipo de datos Descripción
identificación Cadena Indica un ID único que se asigna a cada notificación.
tipo Cadena Indica el tipo de evento.
Se ha eliminado el registro: DELETE_RECORD
aplicación Objeto El objeto que presenta información de la aplicación.
ID de aplicación Cadena Indica el ID de la aplicación.
nombre de la aplicación Cadena Indica el nombre de la aplicación.
ID de registro Cadena Indica el número de registro. Esto no incluye el código de la aplicación.
eliminadoPor Objeto El objeto que presenta información sobre el usuario que eliminó el registro.
eliminadoPor.código Cadena Indica el nombre de inicio de sesión del usuario.
eliminadoPor.nombre Cadena Indica el nombre de usuario.
eliminadoEn Cadena Indica la fecha y hora en que se elimina el registro.

Ejemplo Notificación

{
    "app":{
        "id":"1",
        "name":"Lead Management"
        },
    "id":"01234567-0123-0123-0123-0123456789ab",
    "recordId":"2",
    "deletedBy":{
        "code":"jones",
        "name":"John Jones"
        },
    "deletedAt":"2017-07-03T09:38:09Z",
    "type":"DELETE_RECORD"
}

Comentario publicado

Parámetro Tipo de datos Descripción
aplicación Objeto El objeto que presenta información de la aplicación.
ID de aplicación Cadena Indica el ID de la aplicación.
nombre de la aplicación Cadena Indica el nombre de la aplicación.
comentario Objeto El objeto que presenta información sobre el comentario.
El formato del objeto es el mismo que el de la API REST utilizada para recuperar comentarios de registros.
Obtener Comentarios (Kintone Developer Program)
identificación Cadena Indica un ID único que se asigna a cada notificación.
ID de registro Cadena Indica el número de registro. Esto no incluye el código de la aplicación.
tipo Cadena Indica el tipo de evento.
Comentario publicado: ADD_RECORD_COMMENT
URL Cadena Indica el enlace permanente del comentario.

Ejemplo Notificación

{
    "app":{
        "id":"1",
        "name":"Lead Management"
        },
    "comment":{
        "createdAt":"2012-02-03T09:38:09Z",
        "creator":{
            "code":"kato",
            "name":"Misaki Kato"
            },
        "id":"11",
        "mentions":[{
                    "code":"kato",
                    "type":"USER"
                },{
                "code":"org1",
                "type":"ORGANIZATION"
                },{
            "code":"group1",
            "type":"GROUP"
            }],
"text":"I visited Cybozu, Inc."
},
"id":"01234567-0123-0123-0123-0123456789ab",
"recordId":"2",
"type":"ADD_RECORD_COMMENT",
"url":"https://example.cybozu.com/k/1/show#record=2&comment=11"
}