初始化

  • 接口:common/credits/init
  • Method:POST
  • 数据格式:JSON
  • 限流信息:100次每天和50次每小时
  • 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
  • 接口说明:根据用户的编码初始化信用分
  • 其他补充信息:

参数:

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 当前次接口同步的唯一标识 TRUE 36
timestamp long 当前次接口同步时间对应的时间戳 TRUE 13
data.employee_name String 员工编号(employee_number和user_name二选一,如果全写,employee_number优先) FALSE
data.user_name String 用户名(employee_number和user_name二选一,如果全写,employee_number优先) FALSE 64
data.description String 主数据类型下的基础数据描述 FALSE 64
data.score String 初始化的信用分 FALSE 128

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码(见附录)
resMsg String 返回信息描述
bizId String 当前次接口同步的唯一标识
data.employee_number String 工号
data.user_name String 用户名
data.score Integer 用户信用分
data.adjust_score Integer 调整的信用分

示例:

请求数据

{
  "bizId": "11dba299-b909-4eb8-8e68-291b55ddfc11",
  "timestamp": 1588748999148,
  "data": {
    "description": "用户信用分调整",
    "score": 300,
    "employee_number": "zto999996"
  }
}

返回数据

{
  "resCode": 200000,
  "resMsg": "用户之前信用分较低,因此初始化为当前分",
  "bizId": "11dba299-b909-4eb8-8e68-291b55ddfc11",
  "data": {
    "score": 300,
    "employee_number": "zto999996",
    "adjust_score": 113
  }
}

results matching ""

    No results matching ""