 客服熱線:560+104
數據服務管理
此功能已過時,建議使用新版的接口。接口文檔:https://civetinterface.foxconn.com/ChannelApi/v2/BelieveApi/Document

使用用戶通過生活頻道賬號在生活頻道操作平臺(https://civetpublic.foxconn.com/)進行服務的申請

用戶在智能回復開發者模式中,點擊申請開通數據服務按鈕,進入申請權限變更,填寫并提交申請資料之后,需打印PDF文檔。注明:請確認PDF文檔與申請信息相同。

 目錄[隱藏]
1 申請、查看狀態
2 設置密鑰
3 查看接口調用記錄
4 調用SDK或Web API
申請、查看狀態

數據服務申請:1.用戶點擊“申請權限變更”,進入申請頁面。勾選所需接口、欄位的權限并填寫用戶信息,點擊“修改申請”提交 2.打印PDF文檔,上傳已簽核的PDF文檔,即完成數據服務的申請,等待系統管理員的審核即可。

查看狀態:點擊申請記錄欄的“展開”即可查看審核的狀態和詳情

設置密鑰

在頁面點擊”修改密鑰“進行設置密鑰

查看接口調用記錄

在接口調用統計操作欄點擊”詳情“,可查看接口調用的詳細信息

調用SDK或Web API

.net SDK說明

若您使用.net開發建使用.net SDK,Web API接口說明可以忽略。若使用其它語言開發,可直接調用Web API。
.net SDK下載的地址:https://civetpublic.foxconn.com/content/CivetUserInfoAPP.zip
調用方法,按工號查詢信息為例:

Web API接口通用說明

所有接口必須包含以下四個請求值

timestamp:時間截,格式為yyyy-MM-dd HH:mm:ss,如:2017-04-01 11:54:00

app_id:你的生活頻道的APPID,如:LznNo6l-CTUU4h6ssfw12

nonce_str: 隨機數,任意英文字母或數字組成的字符串,如:6677

sign:簽名,除自己外所有參數按參數字段名稱英文字母排序(升序),再加&key=[你的密鑰,假設為:666666]的MD5加密值。

如:要輸入工號emp_no=X0000001,三個必要請求值如上,則sign值為MD5(app_id=LznNo6l-CTUU4h6ssfw12&emp_no=X0000001&nonce_str=6677&timestamp=2017-04-01 11:54:00&key=666666),即sign值為F2C7652CF49315CDDBF81CD879AD5114

接口返值包含

return_result:執行結果,值有Success(成功)、Fail(失敗)。

message:執行的錯誤信息。

Data:相關數據。

一:按工號查詢員工信息

名稱、識別字按工號查詢員工信息
功能描述按工號查詢員工信息
.net SDKpublic static string SearchByEmpNo(string emp_no)
URLhttps://civetinterface.foxconn.com/UserInfoAPI/Interface/SearchByEmpNo
MethodPOST 方法
request typetext/json
Request Body{

  "timestamp": "2017-04-01 11:54:00",

  "app_id": "LznNo6l-CTUU4h6ssfw12",

  "nonce_str": "6677",

  "emp_no": "X0000001",

  "sign": "4D484DNH345HJR33H7H8900fw123"

}

Response typetext/json
Response Body{

  "return_result": "Success",

  "message": "",

  "data": [

    {

      "USERNAME": "X0000001",

      "FN": "張三",

      "SEX": "男",

      "COUNTRY": "CN",

      "SUBORG": "J",

      "ORGNAME": "XXX(深圳)有限公司",

      "BG": "總部周邊",

      "BU": "XXXX",

      "COST_CODE": "DAAA07",

      "AREA": "龍華",

      "BIRTHDAY": "1987/01/27",

      "EDU_DEGREE": "本科",

      "CLASS": "師三",

      "TITLE": "課長",

      "GRADE": "XX 工程",

      "JOB_STATUS": "在職",

      "HIREDATE": "2016-08-10",

      "LEAVEDATE": "",

      "CIVETID": "Zhang",

      "HEAD": "http://qaicivetmedia.foxconn.com/group1/M00/08/C2/CoaWx1cEn_2EEbajAAAAAKz3WPs002.png"

    }

  ]

}

補充說明請求值說明:

emp_no:工號,必填

返回值說明:

data:返回數據的欄位,根據數據欄位顯示。


二:按姓名查詢員工信息

名稱、識別字按姓名查詢員工信息
功能描述按姓名查詢員工信息
.net SDKpublic static string SearchByEmpName(string emp_name, string bg_name = null, string bu_name = null, int page_num = -1, int page_size = -1)
URLhttps://civetinterface.foxconn.com/UserInfoAPI/Interface/SearchByEmpName
MethodPOST 方法
request typetext/json
Request Body{

  "timestamp": "2017-04-01 11:54:00",

  "app_id": "LznNo6l-CTUU4h6ssfw12",

  "nonce_str": "6677",

  "emp_name": "張三",

  "bg_name": "總部周邊",

  "bu_name": "XXXX",

  "dept_name": "XXX(部門)",

  "page_size": 20,

  "page_num": 1,

  "sign": "4D484DNH345HJR33H7H8900fw123"

}

Response typetext/json
Response Body{

  "return_result": "Success",

  "message": "",

  "data": [

    {

      "USERNAME": "X0000001",

      "FN": "張三",

      "SEX": "男",

      "COUNTRY": "CN",

      "SUBORG": "J",

      "ORGNAME": "XXX(深圳)有限公司",

      "BG": "總部周邊",

      "BU": "XXXX",

      "COST_CODE": "DAAA07",

      "AREA": "龍華",

      "BIRTHDAY": "1987/01/27",

      "EDU_DEGREE": "本科",

      "CLASS": "師3",

      "TITLE": "課長",

      "GRADE": "XX 工程",

      "JOB_STATUS": "在職",

      "HIREDATE": "2016-08-10",

      "LEAVEDATE": "",

      "CIVETID": "Zhang",

      "HEAD": "http://qaicivetmedia.foxconn.com/group1/M00/08/C2/CoaWx1cEn_2EEbajAAAAAKz3WPs002.png"

    }

  ]

}

補充說明請求值說明:

emp_name:姓名,必填

bg_name:[不必填]事業群

bu_name:[不必填]事業處

dept_name:[不必填]部門

page_size:[不必填]每頁多少條

page_num:[不必填]頁碼

返回值說明:

data:返回數據的欄位,根據申請欄位顯示。


三:按入職日期查詢員工信息

名稱、識別字按入職日期查詢員工信息
功能描述按入職日期查詢員工信息
.net SDKpublic static string SearchByHiredate(DateTime hiredate, string bg_name = null, string bu_name = null, int page_num = -1, int page_size = -1)
URLhttps://civetinterface.foxconn.com/UserInfoAPI/Interface/SearchByHiredate
MethodPOST 方法
request typetext/json
Request Body{

  "timestamp": "2017-04-01 11:54:00",

  "app_id": "LznNo6l-CTUU4h6ssfw12",

  "nonce_str": "6677",

  "hiredate": "2016-08-10",

  "bg_name": "總部周邊",

  "bu_name": "XXXX",

  "dept_name": "XX(部門)",

  "page_size": 20,

  "page_num": 1,

  "sign": "4D484DNH345HJR33H7H8900fw123"

}

Response typetext/json
Response Body{

  "return_result": "Success",

  "message": "",

  "data": [...]

}

補充說明請求值說明:

hiredate:入職日期,必填

bg_name:[不必填]事業群

bu_name:[不必填]事業處

dept_name:[不必填]部門

page_size:[不必填]每頁多少條

page_num:[不必填]頁碼

返回值說明:

data:返回數據的欄位,根據申請欄位顯示。


四:獲得某天入職的員工工號、姓名列表

名稱、識別字獲得某天入職的員工工號、姓名列表
功能描述獲得某天入職的員工工號、姓名列表
.net SDKpublic static string GetEmpNoByHiredate(DateTime hiredate, string bg_name = null, string bu_name = null, int page_num = -1, int page_size = -1)
URLhttps://civetinterface.foxconn.com/UserInfoAPI/Interface/GetEmpNoByHiredate
MethodPOST 方法
request typetext/json
Request Body{

  "timestamp": "2017-04-01 11:54:00",

  "app_id": "LznNo6l-CTUU4h6ssfw12",

  "nonce_str": "6677",

  "hiredate": "2016-08-10",

  "bg_name": "總部周邊",

  "bu_name": "XXXX",

  "dept_name": "XX(部門)",

  "page_size": 20,

  "page_num": 1,

  "sign": "4D484DNH345HJR33H7H8900fw123"

}

Response typetext/json
Response Body{

  "return_result": "Success",

  "message": "",

  "data": [...]

}

補充說明請求值說明:

hiredate:入職日期,必填

bg_name:[不必填]事業群

bu_name:[不必填]事業處

dept_name:[不必填]部門

page_size:[不必填]每頁多少條

page_num:[不必填]頁碼

返回值說明:

data:返回數據的欄位,根據申請欄位顯示。


五:獲得某天離職的員工工號、姓名列表

名稱、識別字獲得某天離職的員工工號、姓名列表
功能描述獲得某天離職的員工工號、姓名列表
.net SDKpublic static string GetEmpNoByResigningDate(DateTime resigning_date, string bg_name = null, string bu_name = null, int page_num = -1, int page_size = -1)
URLhttps://civetinterface.foxconn.com/UserInfoAPI/Interface/GetEmpNoByResigningDate
MethodPOST 方法
request typetext/json
Request Body{

  "timestamp": "2017-04-01 11:54:00",

  "app_id": "LznNo6l-CTUU4h6ssfw12",

  "nonce_str": "6677",

  "resigning_date": "2016-08-10",

  "bg_name": "總部周邊",

  "bu_name": "XXXX",

  "dept_name": "XX(部門)",

  "page_size": 20,

  "page_num": 1,

  "sign": "4D484DNH345HJR33H7H8900fw123"

}

Response typetext/json
Response Body{

  "return_result": "Success",

  "message": "",

  "data": [...]

}

補充說明請求值說明:

resigning_dat:離職日期,必填

bg_name:[不必填]事業群

bu_name:[不必填]事業處

dept_name:[不必填]部門

page_size:[不必填]每頁多少條

page_num:[不必填]頁碼