Femas HR
API Document
API SPEC
API Document
API SPEC
  1. 人事
  • 根目錄
    • 身分權限認證
      • 用戶登入
    • 資料讀取
      • 人事
        • 取得人員資料
          POST
        • 取得人員異動資料
          POST
        • 取得公司資料
          POST
        • 取得部門資料
          POST
        • 取得部門異動資料
          POST
        • 取得職稱資料
          POST
        • 取得職等資料
          POST
        • 取得職級資料
          POST
        • 取得員工類別資料
          POST
        • 取得學歷類別資料
          POST
        • 取得國別資料
          POST
        • 取得系統員工大頭照片
          GET
      • 差勤
        • 取得差假資料
        • 取得加班資料
        • 取得差勤資訊
        • 取得假日行事曆資料
      • 排班
        • 取得排班資訊
      • 薪資
        • 取得成本中心資料
        • 取得員工薪資發放方式
        • 取得員工薪資基本資料
        • 取得員工薪資明細表
        • 取得傳票資料
    • 資料寫入
      • 人事
        • 人員新進作業
        • 調派人員作業
        • 離退人員作業
        • 留停人員作業
        • 人員復職回任作業
        • 人員資料批次更新作業
        • 員工眷屬批量維護作業
        • 部門批量維護作業
      • 薪資
        • 成本中心批量維護作業
API Document
API SPEC
API Document
API SPEC
  1. 人事

取得人員資料

POST
https://mock.apidog.com/m1/1073975-0-default/fsapi/V3/su_users.json
資料讀取人事
配合授權管理員使用,預設取回所有人員資料(包含在職/離職/留停/待報到) 建議配合查詢條件避免一次取回太多資料

請求

標頭參數

主體參數application/json

範例
{
    "isWorking": false,
    "isLeaving": false,
    "isUnpaiding": true,
    "isPending": false,
    "userSn": "E10001,E10002",
    "departmentSn": "D001,D002",
    "orgName": "台灣科技股份有限公司",
    "userType": "正式員工",
    "leaveStart": "2023-01-01",
    "leaveEnd": "2024-12-31",
    "arriveStart": "2023-01-01",
    "arriveEnd": "2023-12-31",
    "created": "2023-06-01",
    "modified": "2024-01-15",
    "findFields": [
        "sn",
        "name",
        "email"
    ],
    "limit": "100",
    "offset": "0"
}

請求程式碼範例

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
請求請求範例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://mock.apidog.com/m1/1073975-0-default/fsapi/V3/su_users.json' \
--header 'Authorization: ***********************************' \
--header 'Content-Type: application/json' \
--data-raw '{
    "isWorking": false,
    "isLeaving": false,
    "isUnpaiding": true,
    "isPending": false,
    "userSn": "E10001,E10002",
    "departmentSn": "D001,D002",
    "orgName": "台灣科技股份有限公司",
    "userType": "正式員工",
    "leaveStart": "2023-01-01",
    "leaveEnd": "2024-12-31",
    "arriveStart": "2023-01-01",
    "arriveEnd": "2023-12-31",
    "created": "2023-06-01",
    "modified": "2024-01-15",
    "findFields": [
        "sn",
        "name",
        "email"
    ],
    "limit": "100",
    "offset": "0"
}'

回應

🟢200成功
*/*
success
主體

範例
{
    "response": {
    "status": "success",
    "err_msg": "",
    "datas_count": 150,
    "limit": 100,
    "offset": 0,
    "datas": [
        {
        "sn": "E10001",
        "name": "陳建明",
        "en_name": "James Chen",
        "id_num": "A123456789",
        "sex": "M",
        "married": 1,
        "birthday": "1990-05-15",
        "arrivedate": "2023-03-01",
        "leavedate": null,
        "unpaid_leavedate": null,
        "job_status": "working",
        "officephone1": "02-27123456",
        "officephone2": "02-27123457",
        "cellphone": "0912-345678",
        "email": "[email protected]",
        "photo": "https://hr.company.com.tw/photos/E10001.jpg",
        "org_brief_name": "台灣科技",
        "department_sn": "D001",
        "user_title_sn": "T001",
        "user_title": "資深工程師",
        "user_title_executive":true,
        "position_title": "軟體開發",
        "user_grade_sn": "G001",
        "user_grade": "P3",
        "user_type_sn": "T001",
        "user_type": "正式員工",
        "boss_sn": "E10100",
        "back_seniority": "5",
        "created": "2023-03-01 09:00:00",
        "modified": "2024-01-15 14:30:00",
        "agents": [
            {
            "sn": "E10002",
            "name": "王小華"
            },
            {
            "sn": "E10003",
            "name": "李美玲"
            }
        ],
        "advanced_fields": [
            {
            "code": "Q1",
            "name": "專長技能",
            "value": "Python、Java、系統架構設計"
            },
            {
            "code": "Q2",
            "name": "證照",
            "value": "AWS認證架構師、PMP專案管理師"
            }
        ],
        "emergency_contact1": "陳大明",
        "emergency_phone1": "0987-654321",
        "emergency_contact2": "陳王美華",
        "emergency_phone2": "0912-876543",
        "addr": "台北市信義區信義路五段100號",
        "org_sn": "O001",
        "org_name": "台灣科技股份有限公司",
        "cost_center_sn": "C001",
        "cost_center_name": "研發中心",
        "country_sn": "TW",
        "education_record": [
            {
            "id": "1",
            "education_type_id": "4",
            "name": "國立台灣大學",
            "department_name": "資訊工程學系",
            "started_date": "2008-09-01",
            "ended_date": "2012-06-30",
            "status": "graduated",
            "type_name": "大學",
            "type_code": "4"
            }
        ],
        "work_experience": [
            {
            "id": "1",
            "type": "1",
            "org_name": "某資訊科技公司",
            "department_name": "研發部",
            "sub_dept_name": "軟體開發組",
            "onsite_dept_name": "台北辦公室",
            "user_title_name": "軟體工程師",
            "position_title": "系統開發",
            "grade": "P2",
            "job_grade": "P2",
            "director_name": "張經理",
            "job_content": "負責後端系統開發與維護",
            "started_date": "2018-07-01",
            "ended_date": "2023-02-28",
            "seniority": "5",
            "leave_reason": "職涯發展",
            "comments": "表現優異",
            "user_change_id": "1",
            "department_change_id": "42"
            }
        ],
        "military_service_record": [
            {
            "army": "陸軍",
            "started_date": "2012-07-01",
            "ended_date": "2013-06-30"
            }
        ],
        "enable": true
        }
    ]
    }
}
🟠401未認證
修改時間 2025-11-13 01:11:35
上一頁
用戶登入
下一頁
取得人員異動資料
Built with