cybozu.com 共通 API ドキュメント

ユーザーを取得する

目次

ユーザーを取得する

ユーザー情報を取得します。

CSV ファイルをエクスポートする API の詳細は、 ユーザー情報をエクスポートする を参照してください。

URL

https://sample.cybozu.com/v1/users.json

HTTP メソッド

GET

必要なアクセス権

なし

リクエスト

パラメーター
パラメーター名 型 必須 説明
ids 配列 省略可 ユーザー ID の一覧
codes は同時に指定できません。
ids と codes のどちらも省略すると、最大 100 件のユーザー情報を取得します。
codes 配列 省略可 ユーザーのログイン名の一覧

ids は同時に指定できません。
ids と codes のどちらも省略すると、最大 100 件のユーザー情報を取得します。
size 数値 省略可 取得するユーザーの件数
1 から 100 まで指定できます。省略すると 100 が設定されます。
offset 数値 省略可 取得するユーザーの先頭からスキップする数
0 から無限大の数値を指定できます。
省略すると、 0 が設定されます。
リクエストの例
URL

https://sample.cybozu.com/v1/users.json?ids[0]=1&ids[1]=2&ids[2]=3&offset=0&size=100

ヘッダー
1
2
3

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}

リクエストヘッダーの詳細は User API の共通仕様 を参照してください。

レスポンス

プロパティ
プロパティ名 型 説明
user 配列 ユーザ情報の一覧
詳細は User 型 を参照してください。
並び順は、users[].id の昇順です。
レスポンスの例
 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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

{
  "users": [
    {
      "birthDate": "1995-09-17",
      "callto": "",
      "code": "a",
      "ctime": "2022-07-22T08:12:18Z",
      "customItemValues": [
        {
          "code": "item1",
          "value": "aitem1"
        },
        {
          "code": "secret",
          "value": "aitem2"
        }
      ],
      "description": "",
      "email": "",
      "employeeNumber": "",
      "extensionNumber": "",
      "givenName": "",
      "givenNameReading": "",
      "id": "1",
      "joinDate": "2022-01-01",
      "localName": "",
      "localNameLocale": "ja",
      "locale": "",
      "mobilePhone": "",
      "mtime": "2022-07-22T09:00:00Z",
      "name": "a",
      "phone": "",
      "primaryOrganization": null,
      "sortOrder": 2147483647,
      "surName": "a",
      "surNameReading": "",
      "timezone": "Asia/Tokyo",
      "url": "",
      "valid": true
    },
    {
      "birthDate": null,
      "callto": "",
      "code": "Administrator",
      "ctime": "2022-07-19T08:16:00Z",
      "customItemValues": [
        {
          "code": "item1",
          "value": "adminitem1"
        },
        {
          "code": "secret",
          "value": "adminitem2"
        }
      ],
      "description": "",
      "email": "",
      "employeeNumber": "",
      "extensionNumber": "",
      "givenName": "",
      "givenNameReading": "",
      "id": "7532782697181632512",
      "joinDate": null,
      "localName": "",
      "localNameLocale": "ja",
      "locale": "",
      "mobilePhone": "",
      "mtime": "2022-07-22T08:13:00Z",
      "name": "Administrator",
      "phone": "",
      "primaryOrganization": null,
      "sortOrder": 2147483647,
      "surName": "",
      "surNameReading": "",
      "timezone": "Asia/Tokyo",
      "url": "",
      "valid": true
    }
  ]
}

制限事項

  • kintone のゲストユーザーは取得できません。