■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
勤怠部門管理者の role が self_only から attendance_manager に変更されます。
お客様のアプリケーションに影響を与える可能性があります。お手数ですが、以下の内容をご確認の上、ご対応をお願いいたします。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：freee人事労務 API
変更種別：Breaking Change
変更内容：
– /api/v1/users/me (ログインユーザーの取得) のレスポンスが変更されます。
条件: 勤怠部門管理者で当該 API を呼び出した場合
差分: role の値が self_only から attendance_manager に変化
変更理由：利便性のため。これまで一般と勤怠部門管理者は同じ self_only であったため区別が付きませんでした。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2025年8月21日
変更リリース予定日：2025年9月21日以降
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
お使いのアプリケーションで、role の値を確認している箇所がないかご確認いただき、必要に応じて修正をお願いいたします。
GET /api/v1/users/me を利用し、レスポンスに含まれる role の値が self_only であることを前提とした処理を実装している場合に影響があります。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：/api/v1/users/me
リクエスト：GET
勤怠部門管理者が API を呼び出した場合の role が変化します:
修正前:
{
"id": 1,
"companies": [
{
"id": 100,
"name": "株式会社フリー",
"role": "self_only",
"external_cid": "000-000-000",
"employee_id": 10,
"display_name": "フリー太郎"
}
]
}
修正後:
{
"id": 1,
"companies": [
{
"id": 100,
"name": "株式会社フリー",
"role": "attendance_manager",
"external_cid": "000-000-000",
"employee_id": 10,
"display_name": "フリー太郎"
}
]
}