職級修正

    職級情報を修正します。

    参考

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

    注意

    • フィールド値が null なら既存のデータを維持し、空の値 (Stringの ""、または Listの [] など ) であれば、保存されているデータを消去します。

    • 例 ) 現在保存されているデータが i18nNames : [{"name": "aa", "language": "ko_KR"}, {"name": "bb", "language": "en_US"}]のとき

      • i18nNames の値が null なら、保存されるデータは [{"name": "aa", "language": "ko_KR"}, {"name": "bb", "language": "en_US"}] を維持します。
      • i18nNames 値が空の値なら保存されるデータは [] となり、削除されます。
      • i18nNames 値が [{"name": "cc", "language": "ko_KR"}] なら、保存されるデータは [{"name": "cc", "language": "ko_KR"}] に変更されます。

    API の種類

    サーバー API

    Request URL

    • サービス: https://apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/levels/{externalKey}
    • テスト: https://sandbox-apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/levels/{externalKey}

    HTTP Method

    PATCH (Content-Type: application/json; charset=UTF-8)

    Path Parameters

    パラメーター タイプ 上限 必須 説明
    domainId Integer Y ドメイン ID
    externalKey String 100字 Y 修正する職級の External Key

    Request Body

    パラメーター タイプ 上限 必須 説明
    name String 100 字 Y 職級名。ドメイン内でユニークでなければなりません。
    許容される特殊文字: !@&()-_+[]{},./
    sortLevel Integer Y 整列順。重複を許可します。
    executive Boolean Y 役員であるかどうか
    i18nNames List N 多言語名リスト。多言語コード。付録の言語コード参照。
       name String 100 字 Y 多言語名。
    許容される特殊文字: !@&()-_+[]{},./
       language String Y 言語コード

    Request Example

    PATCH https://apis.worksmobile.com/r/apiid/organization/v2/domains/123/levels/EX123
    
    {
        "name": "社員",
        "sortLevel": 5,
        "executive": false,
        "i18nNames": [
            {
              "name":"사원",
              "language":"ko_KR"
            },
            {
              "name":"Staff",
              "language":"en_US"
            },
            {
              "name":"员工",
              "language":"zh_CN"
            },
            {
              "name":"職員",
              "language":"zh_TW"
            }
        ]
    }
    

    Response

    API 呼び出しに成功すると HTTP 200 コードと追加された職級情報を返します。

    Response Example

    {
        "name": "사원",
        "externalKey": "EX123",
        "sortLevel": 5,
        "executive": false,
        "i18nNames": [
            {
              "name":"社員",
              "language":"ja_JP"
            },
            {
              "name":"Staff",
              "language":"en_US"
            },
            {
              "name":"员工",
              "language":"zh_CN"
            },
            {
              "name":"職員",
              "language":"zh_TW"
            }
        ]
    }
    

    Error code

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