dingtalk.oapi.project.point.history.page (组织积分功能流水数据分页查询)

组织积分功能流水数据查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cursor Number 必须 0 数据游标,初始传0。后续传入返回参数中的next_cursor值
tenant_id Number 必须 7001 业务ID(固定值,农村积分传7001)
page_size Number 必须 10 每页大小,最大200条
userid String 可选 xxxxx 用户id

响应参数

名称 类型 示例值 描述
result PageResult 返回结果
  • └ next_cursor
  • Number
  • 1588234428359
  • 下次游标开始
  • └ has_more
  • Boolean
  • true
  • 是否有更多数据,如果为false,这表示本次查询没有更多的数据了。
  • list
  • PointHistoryDTO []
  • 结果集数据
  • └ rule_name
  • String
  • 好人好事
  • 对应的行为描述
  • └ rule_code
  • String
  • code1
  • 对应的行为代码(可空)
  • └ uuid
  • String
  • xxxx-xxx-xx
  • 幂等键
  • └ create_at
  • Number
  • 1588234428359
  • 创建时间(精确到毫秒数)
  • └ score
  • Number
  • 100
  • 增加或减少的分数(增加为正数,减少为负数)
  • └ corp_id
  • String
  • xxxx
  • 组织ID
  • └ userid
  • String
  • xxxx
  • 用户id
success Boolean true 是否成功
errcode Number 0 错误码
errmsg String 失败原因 失败原因

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/project/point/history/page");
OapiProjectPointHistoryPageRequest req = new OapiProjectPointHistoryPageRequest();
req.setCursor(0L);
req.setTenantId(7001L);
req.setPageSize(10L);
req.setUserid("xxxxx");
OapiProjectPointHistoryPageResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "result":{
        "next_cursor":1588234428359,
        "has_more":true,
        "list":[
            {
                    "rule_name":"好人好事",
                    "rule_code":"code1",
                    "uuid":"xxxx-xxx-xx",
                    "create_at":1588234428359,
                    "score":100,
                    "corp_id":"xxxx",
                    "userid":"xxxx"
            }
        ]
    },
    "success":true,
    "errcode":0,
    "errmsg":"失败原因"
}

异常示例

  • JSON示例
{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部