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

ユーザーが所属する組織を取得する

目次

ユーザーが所属する組織を取得する

ユーザーが所属する組織と、その組織におけるユーザーの役職を取得します。

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

URL

https://sample.cybozu.com/v1/user/organizations.json

HTTP メソッド

GET

必要なアクセス権

なし

リクエスト

パラメーター
パラメーター名 型 必須 説明
code 文字列 必須 ユーザーのログイン名
リクエストの例
URL

https://sample.cybozu.com/v1/user/organizations.json?code=sato-noboru

ヘッダー
1
2
3

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

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

レスポンス

プロパティ
プロパティ名 型 説明
organizationTitles 配列 ユーザーが所属する組織と役職の一覧
詳細は OrganizationTitle 型 を参照してください。
レスポンスの例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

{
  "organizationTitles": [
    {
      "organization": {
        "code": "Sales01",
        "description": "国内営業部",
        "id": "2",
        "localName": "Domestic Sales Department",
        "localNameLocale": "en",
        "name": "国内営業部",
        "parentCode": "A"
      },
      "title": {
        "code": "Manager",
        "description": "マネージャー",
        "id": "1",
        "name": "マネージャー"
      }
    }
  ]
}

サンプルコード

curl を使ったリクエスト
1
2

curl -X GET 'https://sample.cybozu.com/v1/user/organizations.json?code=sato-noboru' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU='

制限事項

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