產生API權杖

文章編號:040471

在外部程式中使用kintone REST API時,使用API權杖來進行驗證。

對請求的「X-Cybozu-API-Token」header指定API權杖,即可驗證請求,並執行API。可利用逗號分隔,指定多個API權杖。

使用API權杖的請求範例:
GET /k/v1/record.json?app=7&id=100 HTTP/1.1
Host: example.cybozu.cn:443
X-Cybozu-API-Token:cJrAD9Es62qm0Z3eE6uzQQmaDxM3q9jiDay1oysX
使用多個API權杖,在Lookup中取得顧客名稱的範例:
curl -X POST -H "X-Cybozu-API-Token: cJrAD9Es62qm0Z3eE6uzQQmaDxM3q9jiDay1oysX, 6oDAV8hCY6HTa1AC6EZbNe2dpc1t8QnWZrHOMgMb" "https://(子網域名).cybozu.cn/k/v1/record.json" -H "Content-Type: application/json" -d '{app: 20, record: {"顧客名稱": {value: "金都運總研"}}}'

產生API權杖

  1. 在「記錄清單」畫面中,點擊畫面右上方齒輪形狀的[設定應用程式]圖示。
    截圖:框線強調[設定應用程式]圖示

  2. 在「應用程式的設定」畫面中,點擊[設定]分頁的「自訂/服務整合」中的[API權杖]。

  3. 在「API權杖」畫面中,點擊[產生]。
    截圖:產生按鈕

  4. 對建立的API權杖,在「存取權限」中勾選允許的操作。 截圖:允許的操作的核取方塊

  5. 視需要點擊「備註」的[編輯]圖示,輸入各API 權杖的備註。
    事先記載負責人或使用目的等內容,有助於管理API 權杖。
    截圖:框線強調「備註」

    • 對輸入欄的右下角按住滑鼠左鍵不放並向外拖曳,即可加大欄寬與列高。
    • 最多可輸入200個字元。
  6. 點擊✔形狀的[儲存]圖示儲存備註。
    截圖:儲存按鈕

  7. 點擊畫面右下方的[儲存]。

  8. 點擊畫面右上方的[更新應用程式]。

  9. 在「更新應用程式」對話方塊中,點擊[更新應用程式]。