La API de usuario es una API REST que obtiene, agrega y actualiza información de usuario/grupo/departamento.

La API de REST de usuario requiere autenticación de contraseña, con las claves y los valores adecuados establecidos en el encabezado de la solicitud. Si la función de seguridad de autenticación básica también está configurada en su dominio, se requerirán tanto encabezados para la autenticación de contraseña como para la autenticación básica para la solicitud.

Establezca **X-Cybozu-Authorization** en el encabezado de la solicitud, con un nombre de inicio de sesión y una contraseña codificados en BASE64 como valor.
Si su nombre de inicio de sesión es Tono de "kintone" y su contraseña es "developer", codificación BASE64 "Kintone:developer" y configúrelo en el encabezado de la siguiente manera:

1

X-Cybozu-Authorization: S2ludG9uZTpkZXZlbG9wZXI=

La autenticación de sesión es un método de autenticación en el que el servidor web asigna un ID de sesión a un usuario y lo guarda como una cookie. Esta cookie se utiliza para identificar y autenticar al usuario. La autenticación de sesión solo puede ser utilizada por códigos JavaScript que se ejecutan en las páginas de Kintone. Los tokens CSRF son necesarios cuando se utiliza la autenticación de sesión con métodos POST ／ PUT ／ DELETE. Consulte la siguiente documentación para obtener más detalles sobre la recuperación de un token CSRF:
Get CSRF Token

La prioridad de la autenticación es la siguiente.

1. Autenticación con contraseña
2. Autenticación de sesión

Advertencia

A partir de junio de 2020, la autenticación básica ha quedado obsoleta y ya no está disponible para su uso.

Si su entorno Kintone ha establecido la función de seguridad de autenticación básica, agregue Autorización en el encabezado de la solicitud, con la cadena Basic y un nombre de inicio de sesión y contraseña codificados en BASE64 de la autenticación básica como valor.
Si el nombre de inicio de sesión de autenticación básica es "chocolate" y la contraseña de autenticación básica es "pudding", lugar "Basic " en el valor, seguido de un BASE64 codificado "Chocolate:pudín" de la siguiente manera:

1

Authorization: Basic Y2hvY29sYXRlOnB1ZGRpbmc=

Estos encabezados de solicitud se utilizan para la API de REST.

El código de estado HTTP 200 indica que la solicitud se realizó correctamente.
Trate cualquier otro código de estado como errores. Los errores responderán con datos JSON, incluida la siguiente información.

1
2
3
4
5

{
  "message": "Invalid JSON string.",
  "id": "1505999166-897850006",
  "code": "CB_IJ01"
}

• Agregue el encabezado X-HTTP-Method-Override para evitar el error URI de solicitud demasiado grande que se produce cuando el URI de solicitud supera los 4 KB. Todas las API de usuario admiten este encabezado.
• Si se envía una solicitud GET de una API de usuario mediante el método de solicitud de API REST de Kintone y la longitud del URI supera los 4 KB, el encabezado X-HTTP-Method-Override se agregará automáticamente y la solicitud se enviará como una solicitud POST. Esto permite que las solicitudes de API de usuario con URI largos se ejecuten sin errores.
  Para obtener más información sobre el método de solicitud de API REST de Kintone, consulte el siguiente enlace:
  Solicitud de API REST de Kintone