初始化
- 接口: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
}
}