睿绩效开放API文档
KPI 接口文档
一、接口访问规则
1.注册时指定每个公司有总访问量上限,暂不限制
2.每个公司每小时调用所有接口累计不超过1000次
3.接口地址：https://rrs.pekhr.com/v2/api
二、公开接口
1.获取token接口
URL
/open/tenant/getAccessToken?corpId={corpId}&signature={signature}&timestamp={timestamp}
请求参数
corpId
ding_corp_id
signature
签名
签名算法：
md5(crop_id+access_key+access_secret+timestamp)
注意拼接时不需要"+"号
timestamp
时间戳 单位是 ms , 需要和 md5签名中的一致
timestamp在十分钟内有效
返回
8
{
  "code": 0,
  "data": "ding5018ebab050977b1acaaa37764f94726_d3123bb9b9af4b6da646fa8d8e4f98d9",
  "message": "",
  "success": true
}

﻿
data
access token 一小时内有效
2.分页查询考核周期
URL
/open/tenant/eval/pagedCycle?token={token}pageSize={pageSize}&pageNo={pageNo}
请求参数
token
access token，getAccessToken接口获取
fromTime
创建时间的起始时间,格式:2023-02-08 23:00:00,查询此时间点以后创建的周期 可选
pageNo
页码，必选
pageSize
每页数据量，最大100，必选
返回值
{
    "data": [
        {
           "createdTime": "2024-02-22 14:58:28"
            "cycleEnd": "2023-03-31",
            "cycleStart": "2023-01-01",
            "cycleStatus": "normal",
            "id": "1834902",
            "name": "【示例】2023年第1季度考核周期",
            "type": "quarter",
            "value": 1,
            "year": 2023
        },
       .....
    ],
    "errCode": null,
    "errMessage": null,
    "pageNo": 1,
    "pageSize": 10,
    "success": true,
    "totalPage": 1,
    "totalRow": 3
}
data
周期列表
id
周期ID
createdTime
周期创建时间
name
周期名称
type
考核周期类型:month=月度, cross_month=双月, quarter=季度, half_year=半年度,year=年度
cycleStart
周期开始时间
cycleEnd
周期结束时间
cycleStatus
周期任务状态（normal：正常使用 ）
archive_status
周期归档状态（0未归档，1已归档）
3.分页查询考核任务
URL
/open/tenant/eval/pagedTask?token={token}&name={name}&pageSize={pageSize}&pageNo={pageNo}
请求参数
token
access token，getAccessToken接口获取 必传
cycleId
周期id,可选,从分页查询企业绩效考核的周期接口取得
name
考核任务名称,可选：
1.模糊查询；
2.需要使用URLEncoder编码；
3.编码前最大长度255字符；
pageNo
页码，可选，默认值：1
pageSize
每页数据量，最大100，可选，默认值：10
返回值
﻿
20
{
  "code": 0,
  "data": [
    {
      "cycleEnd": "2022-03-31",
      "cycleStart": "2022-03-01",
      "cycleType": "month",
      "taskId": "7517d3c2-485c-4dba-bc99-4154929cba0c",
      "taskName": "2022年03月全公司互评",
      "taskStatus":"published"
    },
    {...},
    {...},
    {...},
    {...}
  ],
  "message": "",
  "success": true
}
﻿
data
考核列表
taskId
考核任务ID
taskName
考核任务名称
cycleType
考核周期类型
cycleStart
考核开始时间
cycleEnd
考核结束时间
﻿
﻿
taskStatus
考核任务状态（published：已发布  publishing：  terminated:已终止  draft：草稿）
﻿
4.分页查询考核人员的结果
URL
/open/tenant/eval/pagedTalentEval?token={token}&taskId={taskId}&pageSize={pageSize}&pageNo={pageNo}
请求参数
token
access token，getAccessToken接口获取
taskId
考核任务ID，通过pagedTask获取
pageNo
页码，可选，默认值：1
pageSize
每页数据量，最大100，可选，默认值：10
返回值
24
{
  "code": 0,
  "data": [
    {
      "evalId":"1000099",//员工绩效id
      "cycleId":"100000455",//周期id
      "empId": "1109001",
      "dingId": "11091109001001",
      "empName": "欧阳洋",
      "level": "A",
      "score": "100.00",
      "coef":"1.2",
      "reviewers": [
        {
          "empId": "1002344",
          "exUserId": "ding5018ebab050977b1acaaa3"
        }
      ]
    }
  ],
  "message": "",
  "success": true
}
data
考核结果列表
empId
员工ID
empName
员工姓名
level
考核等级
score
考核得分
coef
系数
﻿
﻿
status
考核状态（
drawUpIng：待发起
confirming：指标审核(指标确认)
confirmed：执行中
changing：指标变更中
scoring：评分中
resultsAuditing：考核结果审核中
resultsAffirming：考核结果确认中
waitPublish：待公示
finished：已完成
terminated：已终止
）
﻿
﻿
reviewers
流程责任人列表
﻿
﻿
reviewers.empId
北极星员工id 
﻿
﻿
reviewers.exUserId
所在平台用户id (如:钉钉)
﻿
﻿
﻿
﻿
﻿
﻿
三、错误码
﻿
错误码
msg
﻿
50001
access forbidden
没有注册信息
50002
invalid signature
错误的校验码，或者校验码超时
50003
invalid access token
access token格式错误
50004
invalid access token
access token不存在
50005
invalid access token
access token 过期
50006
invalid access token
错误的access token 
50007
access forbidden
错误的corp id
50008
invalid task name
任务名超过255字符
50009
access limit
访问次数到达上限
50010
auth expires
授权到期
50011
access forbidden
接口访问达到总上限
﻿
﻿