產生API權杖

文章編號:040471

API權杖使用於驗證在外部程式中使用的kintone REST 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.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. 在確認對話方塊中點擊[更新應用程式]。