新增訪客

連結已複製

新增訪客。不會傳送邀請電子郵件。

HTTP 方法	POST
URL	https://sample.cybozu.com/k/v1/guests.json
認證	密碼驗證 , 會話認證 \
Content-Type	application/json

請求參數

連結已複製

參數名稱	類型	必須	說明
guests	陣列	必須	要新增的訪客資訊陣列
guests[].code	字串	必須	要新增的訪客用戶的電子郵件位址
guests[].password	字串	必須	要新增的訪客用戶的密碼
guests[].timezone	字串	必須	要添加的訪客用戶的時區
guests[].locale	字串	可省略	要添加的來訪客戶的語言您可以指定以下值 `auto`：使用瀏覽器的設定 `ja`：日本語 `en`：英語 `zh`：中文（简体）如果省略，則設置為「auto」。
guests[].image	字串	可省略	要新增的訪客用戶的圖像使用上傳檔案API上傳圖片檔案，並指定獲取的檔鍵。上傳檔案的 API 如果省略，則設置初始圖片。
guests[].name	字串	必須	要添加的訪客用戶的顯示名稱指定 1 到 128 個字元。
guests[].surNameReading	字串	可省略	要新增的訪客名指定不超過 64 個字元如果省略，則會設定空字串。
guests[].givenNameReading	字串	可省略	要新增的訪客名指定不超過 64 個字元如果省略，則會設定空字串。
guests[].company	字串	可省略	要新增的訪客的公司名稱指定不超過 100 個字元如果省略，則會設定空字串。
guests[].division	字串	可省略	要新增的訪客用戶的名稱指定不超過 100 個字元如果省略，則會設定空字串。
guests[].phone	字串	可省略	要新增的訪客用戶的電話號碼指定不超過 100 個字元如果省略，則會設定空字串。
guests[].callto	字串	可省略	要新增的訪客的 Skype 名稱指定不超過 256 個字元如果省略，則會設定空字串。

回應屬性

連結已複製

無

所需存取權限

連結已複製

kintone的系統管理員

範例

連結已複製

請求範例

請求標頭

1
2
3
4


{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

有關請求頭的詳細資訊，請參閱通用規格。
kintone REST API通用規格

請求主體

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


{
  "guests": [
    {
      "code": "hoge@example.com",
      "password": "p@ssword",
      "timezone": "Asia/Tokyo",
      "locale": "ja",
      "image": "78a586f2-e73e-4a70-bec2-43976a60746e",
      "name": "東京 三郎",
      "surNameReading": "toukyou",
      "givenNameReading": "saburou",
      "company": "Cybozu, Inc.",
      "division": "営業部",
      "phone": "999-456-7890",
      "callto": "tokyo3rou"
    },
    {
      "code": "fuga@example.com",
      "password": "p@ssword",
      "timezone": "Asia/Tokyo",
      "locale": "auto",
      "image": "c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6",
      "name": "水道橋 二郎",
      "surNameReading": "suidoubashi",
      "givenNameReading": "jirou",
      "company": "Cybozu, Inc.",
      "division": "開発部",
      "phone": "555-1111-2222",
      "callto": "suidobashijiro"
    }
  ]
}

範例回應

1

{}

範例程式碼

使用kintone.api()傳送請求

有關kintone.api()的說明，請參閱以下頁面。
傳送kintone REST API請求

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34


const body = {
  guests: [
    {
      code: 'hoge@example.com',
      password: 'p@ssword',
      timezone: 'Asia/Tokyo',
      locale: 'ja',
      image: '78a586f2-e73e-4a70-bec2-43976a60746e',
      name: '東京 三郎',
      surNameReading: 'toukyou',
      givenNameReading: 'saburou',
      company: 'Cybozu Inc',
      division: '営業部',
      phone: '999-456-7890',
      callto: 'tokyo3rou'
    },
    {
      code: 'fuga@example.com',
      password: 'p@ssword',
      timezone: 'Asia/Tokyo',
      locale: 'auto',
      image: 'c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6',
      name: '水道橋 二郎',
      surNameReading: 'suidoubashi',
      givenNameReading: 'jirou',
      company: 'Cybozu Inc',
      division: '開発部',
      phone: '555-1111-2222',
      callto: 'suidobashijiro'
    }
  ]
};

await kintone.api(kintone.api.url('/k/v1/guests.json', true), 'POST', body);

使用curl傳送請求

根據您的環境，curl的格式可能會有所不同。
有關說明，請參閱以下頁面。
使用curl命令執行kintone REST API中的3.執行API （日語）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35


curl -X POST 'https://sample.cybozu.com/k/v1/guests.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "guests": [
      {
        "code": "hoge@example.com",
        "password": "p@ssword",
        "timezone": "Asia/Tokyo",
        "locale": "ja",
        "image": "78a586f2-e73e-4a70-bec2-43976a60746e",
        "name": "東京 三郎",
        "surNameReading": "toukyou",
        "givenNameReading": "saburou",
        "company": "Cybozu, Inc.",
        "division": "営業部",
        "phone": "999-456-7890",
        "callto": "tokyo3rou"
      },
      {
        "code": "fuga@example.com",
        "password": "p@ssword",
        "timezone": "Asia/Tokyo",
        "locale": "auto",
        "image": "c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6",
        "name": "水道橋 二郎",
        "surNameReading": "suidoubashi",
        "givenNameReading": "jirou",
        "company": "Cybozu, Inc.",
        "division": "開発部",
        "phone": "555-1111-2222",
        "callto": "suidobashijiro"
      }
    ]
  }'

補充

連結已複製

即使禁用了空間功能或訪客空間功能，也可以執行。
如果要邀請他們加入訪客空間，請使用此 API 將他們添加到訪客空間，然後使用更新訪客空間的訪客成員的 API將他們新增到訪客空間
更新訪客空間的訪客API
新增訪客時，將啟用電子郵件通知。

kintone API

kintone API文件

新增訪客

目錄

請求參數

回應屬性

所需存取權限

範例

補充