使用场景：
当积分主体配置为“外部积分系统”时，触发积分明细查询业务时，积分集成服务会请求积分类型自建应用中所配置的接口地址。
...
| Markdown |
|---|
**接口地址** `自建应用配置` **请求方式** `POST` **consumes** `["application/json"]` **produces** `["application/json"]` **接口描述** `企业级接口，hearer必须携带X-Token` **应用权限** `用户->用户资料``积分 -> 外部积分-明细查询` **注意事项** # 请求参数 *** ### 请求头参数 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | X-Token | 自建应用访问token | header | true | string | | ### 公共参数 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | orgId | 企业ID | body | false | string | | | appInstanceId | 应用实例ID | body | false | long | | | openids | 身份识别标识集合 | body | false | array | [身份识别标识](#身份识别标识) | | phoneList | 手机号码列表 | body | false | array | [手机号码](#手机号码) | | audienceUserIds | 客户档案ID集合，客户档案ID为long类型 | body | false | array | | | exchangeTypes | 变动类型集合，1 获得；2 消耗；3 过期积分 | body | false | array | | | startTime | 开始时间 | body | false | date | | | endTime | 截止时间 | body | false | date | | | pageNo | 页码，默认为1 | body | false | int | | | pageSize | 页面大小，默认为20 | body | false | int | | ### 身份识别标识 | 参数名称 instanceAppId| 参数说明 自建应用appid | 请求类型string | 是否必须true | 数据类型String | schema | | ------ | ------ | ------ | ------ | ------ | ------thirdCompanyId| 开放平台登陆componyId | string | 非开放平台用户为空 | String | | | openid orgId| 企业id | bodystring | falsetrue | stringString | | ### 身份识别标识 | unionid参数名称 | 参数说明 | body请求类型 | false是否必须 | string数据类型 | schema | | fromTo------ | 应用类型(contentminiapp:小程序, workwechat:企业微信外部联系人, gzh:公众号, workwechatgroup:客户群) | body | false | string |------ | ------ | ------ | ------ | ------ | | appidopenid | 应用ID | body | false | string | | | jcappidunionid | 系统集成应用实例ID | body | false | longstring | | | identityIdfromTo | 身份识别类型ID 应用类型(contentminiapp:小程序, workwechat:企业微信外部联系人, gzh:公众号, workwechatgroup:客户群) | body | false | string | | | identityTypeappid | 身份识别类型(phone: 手机号码, id: 第三方用户ID, openid: 公众号openid, unionid: 开放平台unionid)应用ID | body | false | string | | | jcappid | 系统集成应用实例ID | body | false | stringlong | | ### 手机号码 | 参数名称identityId | 参数说明身份识别类型ID | 请求类型body | 是否必须false | 数据类型string | schema | | ------identityType | ------ | ------ | ------ | ------ | ------ | | phone | 手机号身份识别类型(phone: 手机号码, id: 第三方用户ID, openid: 公众号openid, unionid: 开放平台unionid) | body | false | string | | ### 手机号码 | isVerify参数名称 | 是否验证(0:未验证, 1:已验证) 参数说明 | body请求类型 | false是否必须 | string数据类型 | schema | ### 请求示例 ```json { "appInstanceId": 0, "audienceUserIds": [860484273911119872], "endTime": "", "exchangeTypes": [], "openids": [ { "appid": "", "fromTo": "", "identityId": "", "identityType": "", "jcappid": 0, "openid": "", "unionid": "" } ], "orgId": "d515fa4b-8def-4188-8415-92632581795c", "pageNo": 1, "pageSize": 10, "phoneList": [ { "isVerify": "", "phone": "" } ], "startTime": "" } ``` # 响应参数 *** | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | code | 状态码 | body | true | string | | | errorCode | 异常码 | body | true | string | | | msg | 描述 | body | true | string | | | data | 积分明细分页结果 | body | true | object | [积分明细分页结果](#积分明细分页结果) | ### 积分明细分页结果 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ---------- | -------- | -------- | -------- | -------- | ----------------------------- | | pageNo | 页码 | body | true | int | | | pageSize | 页面大小 | body | true | int | | | sort | 排序规则 | body | true | string | | | order | 排序字段 | body | true | string | | | totalCount | 总记录数 | body | true | int | | | list | 当页数据 | body | true | array | [积分明细信息](#积分明细信息) | ### 积分明细信息 | 参数名称 | 参数说明 | ------ | ------ | ------ | ------ | ------ | ------ | | phone | 手机号 | body | false | string | | | isVerify | 是否验证(0:未验证, 1:已验证) | body | false | string | | ### 请求示例 ```json { "appInstanceId": 0, "audienceUserIds": [860484273911119872], "endTime": "", "exchangeTypes": [], "openids": [ { "appid": "", "fromTo": "", "identityId": "", "identityType": "", "jcappid": 0, "openid": "", "unionid": "" } ], "orgId": "d515fa4b-8def-4188-8415-92632581795c", "instanceAppId": "Ipu_t60KoV-gTTtCSkFMWtrkTIA", "thirdCompanyId": "0707", "pageNo": 1, "pageSize": 10, "phoneList": [ { "isVerify": "", "phone": "" } ], "startTime": "" } ``` # 响应参数 *** | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | code | 状态码 | body | true | string | | | errorCode | 异常码 | body | true | string | | | msg | 描述 | body | true | string | | | data | 积分明细分页结果 | body | true | object | [积分明细分页结果](#积分明细分页结果) | ### 积分明细分页结果 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | 请求类型 | 是否必须 | 数据类型 | schema | | -------------- | ----------- | -------- | -------- | --------- | -------- | -------- | -------- | ------ | | pageNo | pointRecordId 页码 | body | true | int | 积分记录ID | | bodypageSize | 页面大小 | falsebody | longtrue | int | | pointRuleId | 积分规则ID | | sort | body | false 排序规则 | longbody | true | string | | orgId | | 企业ID | | order | 排序字段 | body | true | string | | | audienceUserId | 客户档案ID | | totalCount | 总记录数 | body | true | string int | | | | nickName | 用户昵称 | | list | 当页数据 | body | true false | intarray | [积分明细信息](#积分明细信息) | ### 积分明细信息 | 参数名称 | | 参数说明 avatar | 用户头像 | 请求类型 | 是否必须 | 数据类型 | schema | | | body | false | string | | | contentId | 内容ID -------------- | ------------------------------------ | -------- | -------- | -------- | ------ | | pointRecordId | 积分记录ID | body | false | long string | | | contentName | 内容名称 pointRuleId | 积分规则ID | body | false | string | | | eventType body | 行为类型false | long | | | orgId | body企业ID | false | string | | | exchangeType | 变动类型，1 获得；2 消耗；3 过期积分 | body | true | int string | | | exchangePoint audienceUserId | 变动积分值客户档案ID | body | true | int string | | | remark nickName | 备注 用户昵称 | body | truefalse | |int string | | | actionTimeavatar | 操作时间用户头像 | body | true false | date string | | | pointSourcecontentId | 积分来源 1| 行为积分内容ID 2 分销积分 | body | false | int | | | extbody | false | 扩展信息string | | | contentName | 内容名称 | body | false | string | | body | ### 响应状态 | 状态码 | 说明 false | schemastring | | ------ | ------ | ------ | | 200 | OK | | | 201eventType | Created | | | 401 | 行为类型 Unauthorized | | | 403 | Forbidden | | | 404 | Not Found | | ### 响应示例 ```json { "code": "200", "errorCode": "SUCCESS", "msg": "ok", "data": { | body "pageNo": 1, | "pageSize": 10, false | "sort": "desc", string | "order": "action_time", "totalCount": 4, | | exchangeType | 变动类型，1 "list": [ 获得；2 消耗；3 过期积分 | body { | true "pointRecordId": null, | int | "pointRuleId": null, | | exchangePoint "orgId": "d515fa4b-8def-4188-8415-92632581795c", | 变动积分值 "audienceUserId": "860484273911119872", "nickName": null, "avatar": null, | body | true "contentId": null, | int "contentName": null, | "eventType": "", | | remark "exchangeType": 2, | 备注 "exchangePoint": 10, "remark": "测试减少", "actionTime": 1636025874340, "pointSource": 1, | body | true "ext": "{\"relateBizCode\":\"业务编码\"}" | string }, | { | | actionTime "pointRecordId": null, | 操作时间 "pointRuleId": null, "orgId": "d515fa4b-8def-4188-8415-92632581795c", "audienceUserId": "860484273911119872", | body | "nickName": null, true | date "avatar": null, | "contentId": null, | | pointSource | 积分来源 1 行为积分 2 "contentName": null, 分销积分 | body "eventType": "", | false "exchangeType": 1, | int | "exchangePoint": 10, | | ext "remark": "测试增加", "actionTime": 1636025753625, | 扩展信息 "pointSource": 1, "ext": "{\"relateBizCode\":\"业务编码\"}" }, | body { | false | string "pointRecordId": null, | "pointRuleId": null, "orgId": "d515fa4b-8def-4188-8415-92632581795c", "audienceUserId": "860484273911119872", "nickName": null, "avatar": null, "contentId": null, "contentName": null, "eventType": "", "exchangeType": 1, "exchangePoint| ### 响应状态 | 状态码 | 说明 | schema | | ------ | ------ | ------ | | 200 | OK | | | 201 | Created | | | 401 | Unauthorized | | | 403 | Forbidden | | | 404 | Not Found | | ### 响应示例 ```json { "code": "200", "errorCode": "SUCCESS", "msg": "ok", "data": { "pageNo": 1, "pageSize": 10, "remarksort": "测试增加desc", "actionTimeorder": 1636025690220"action_time", "pointSourcetotalCount": 14, "extlist": "{\"relateBizCode\":\"业务编码\"}" },[ { "pointRecordId": null, "pointRuleId": null, "orgId": "d515fa4b-8def-4188-8415-92632581795c", "audienceUserId": "860484273911119872", "nickName": null, "avatar": null, "contentId": null, "contentName": null, "eventType": "", "exchangeType": 12, "exchangePoint": 10, "remark": "测试增加测试减少", "actionTime": 16360256461961636025874340, "pointSource": 1, "ext": "{\"relateBizCode\":\"业务编码\"}" } ] } } ``` |
...