发行API令牌

文章编号:040471

API令牌用于验证在外部程序中使用的kintone REST API。
在请求头“X-Cybozu-API-Token”中指定API令牌,即可对请求进行验证并执行API。还可通过用逗号间隔,指定多个API令牌。

使用API令牌的请求的范例:
GET /k/v1/record.json?app=7&id=100 HTTP/1.1
Host: example.cybozu.com:443
X-Cybozu-API-Token:cJrAD9Es62qm0Z3eE6uzQQmaDxM3q9jiDay1oysX
使用多个API令牌,通过Lookup获取客户名称的范例:
curl -X POST -H "X-Cybozu-API-Token: cJrAD9Es62qm0Z3eE6uzQQmaDxM3q9jiDay1oysX, 6oDAV8hCY6HTa1AC6EZbNe2dpc1t8QnWZrHOMgMb" "https://(子域名).cybozu.com/k/v1/record.json" -H "Content-Type: application/json" -d '{app: 20, record: {"客户名称": {value: "金都运总研"}}}'

有关使用API令牌验证的详情,请参考以下页面中的“用户身份验证”。
kintone REST API 的共通规格

发行API令牌的步骤

  1. 点击记录列表页面右上方的齿轮状应用设置图标,选择“设置”标签中“自定义/服务整合”的[API令牌]。 截图:设置图标

  2. 点击[发行]。 截图:发行按钮

  3. 对已发行的API令牌,勾选允许的操作。 截图:允许的操作的复选框

  4. 根据需要,点击备注的“编辑”图标,输入各API令牌的备注。
    通过预先记载负责人或使用目的等,有助于管理API令牌。 截图:输入备注的页面

    • 用鼠标按住输入框的右下角进行拖拽,即可对横向和纵向进行拉伸。
    • 最多可输入200个字符。
  5. 输入备注后,点击“保存”图标保存备注。 截图:保存按钮

  6. 点击页面右下方的[保存]。
    API令牌的设置被保存。

  7. 如要将已保存的设置反映到正式环境中,需点击页面右上方的[更新应用]。

  8. 在确认对话框中点击[更新应用]。