上長情報照会

OpenAPI説明

当該OpenAPIは上長情報の取得に利用します

OpenAPI権限

当該OpenAPIはテナント権限が必要です。

リクエストURI

/api/openapi/department/roles

リクエスト形式

GET

リクエストパラメータ例

• /api/openapi/department/roles?departmentCode=DEP-1&baseDate=2021-03-03
• /api/openapi/department/roles?departmentOID=58516027-c0c9-420a-aedf-f9d74ca4b2ed&baseDate=2021-03-03

リクエストパラメータ説明

departmentCodeとdepartmentOIDの片方をご指定

パラメータ名	タイプ	必須	説明
departmentCode	String		部門コード
departmentOID	UUID		部門OID
baseDate	String		基準日

OpenAPIリターン例

[
    {
        "departmentRoleCode": "3001",
        "employeeId": "EMP-001",
        "fromDate":"2020-04-01",
        "toDate":"2020-04-01"
    },
    {
        "departmentRoleCode": "6101",
        "employeeId": "EMP-002",
        "fromDate":"2020-04-01",
        "toDate":"2020-04-01"
    }
]

OpenAPIリターン項目

パラメータ名	タイプ	規則	説明
departmentRoleUser	DepartmentRoleUser[]		上長情報リスト

DepartmentRoleUser

パラメータ名	タイプ	規則	説明
departmentRoleCode	String	最大20文字	部門ロールコード。部門マネージャーコードは6101
employeeId	String	最大32文字	従業員番号
fromDate	String	日付フォーマット：yyyy-MM-dd	開始日
toDate	String	日付フォーマット：yyyy-MM-dd	終了日

失敗例

{
    "message": "部門は存在しません",
    "errorCode": "6061002"
}

項目説明

項目名	タイプ	説明
message	String	メッセージを返す
errorCode	String	エラーコードを返す

エラーコード説明

errorCode	message	説明
120001	テナントの権限がありません
6061002	部門は存在しない
6013009	日付フォーマットはyyyy-MM-ddです