職級リスト照会

    職級リストを照会します。

    参考

    • ドメインの職級設定が有効に設定されている必要があります。

    API の種類

    サーバー API

    Request URL

    https://apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/levels

    HTTP Method

    GET

    Path Parameters

    パラメーター タイプ 上限 必須 説明
    domainId Integer Y ドメイン ID

    Request Example

    GET https://apis.worksmobile.com/r/apiid/organization/v2/domains/123/levels
    

    Response

    呼び出しに成功すると HTTP 200 コードとドメインの職級リストを返します。

    [
        {
            "externalKey": "EX123",
            "executive": true,
            "sortLevel": 1,
            "name": "役員",
            "i18nNames": [
                {
                  "name":"임원",
                  "language":"ko_KR"
                },
                {
                  "name":"Executive",
                  "language":"en_US"
                },
                {
                  "name":"委员",
                  "language":"zh_CN"
                },
                {
                  "name":"委員",
                  "language":"zh_TW"
                }
            ]
        },
        {
            "externalKey": "EX124",
            "executive": false,
            "sortLevel": 2,
            "name": "社員",
            "i18nNames": [
                {
                  "name":"사원",
                  "language":"ko_KR"
                },
                {
                  "name":"Staff",
                  "language":"en_US"
                },
                {
                  "name":"员工",
                  "language":"zh_CN"
                },
                {
                  "name":"職員",
                  "language":"zh_TW"
                }
            ]
        }
    ]
    

    Error Code

    呼び出しに失敗するとエラーコードとエラーメッセージを返します。
    エラーコードは組織連携REST APIエラーコードを参照してください。