Generating API Tokens
API tokens are used for authenticating kintone REST API requests sent from external programs.
Specifying an API token in the "X-Cybozu-API-Token" header of your REST API request authenticates the request, and the API is executed. You can also specify multiple API tokens with commas in between.
GET /k/v1/record.json?app=7&id=100 HTTP/1.1 Host: example.cybozu.com:443 X-Cybozu-API-Token:cJrAD9Es62qm0Z3eE6uzQQmaDxM3q9jiDay1oysX |
curl -X POST -H "X-Cybozu-API-Token: cJrAD9Es62qm0Z3eE6uzQQmaDxM3q9jiDay1oysX, 6oDAV8hCY6HTa1AC6EZbNe2dpc1t8QnWZrHOMgMb" "https://subdomain name.cybozu.com/k/v1/record.json" -H "Content-Type: application/json" -d '{app: 20, record: {"Customer Name": {value: "kintone Research"}}}' |
For details on authentication using API tokens, refer to the "User Authentication" section in the following page:
kintone REST API Common Specifications
Steps to generate API tokens
-
Click the App Settings icon (the gear-shaped icon at the upper right of the "View" screen), select the App Settings tab, and then select API Token under Customization and Integration.
-
Click Generate.
-
For the generated API token, select the check boxes for the actions you want to allow.
-
If necessary, add notes for the API token by clicking the Edit icon for the Notes input field.
You can use this field to write down the purpose of use, the contact person, etc. This helps you manage your API tokens more easily.- You can enlarge the input field horizontally and/or vertically by dragging its lower right corner with the mouse.
- You can enter up to 200 characters.
-
After entering your notes into the input field, click the Save icon to save them.
-
Click Save on the bottom right side of the screen.
Your API token setting is saved. -
To apply the saved setting to the actual environment, click Update App on the upper right side of the screen.
-
On the confirmation dialog, click Update App.