使用场景:
当积分主体配置为“外部积分系统”时,触发积分增加业务时,积分集成服务会请求积分类型自建应用中所配置的接口地址。企业增加用户积分
Markdown |
---|
**接口地址** `自建应用配置``/api/open/point/increase` **请求方式** `POST` **consumes** `["application/json"]` **produces** `["application/json"]` **接口描述** `企业级接口,hearer必须携带X-Token` **应用权限** `积分 -> 外部积分-增加``无需授权` **注意事项** # 请求参数 #请求参数 *** ### 请求头参数 ###请求头参数 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | X-Token | 自建应用访问token | header | true | string | | ### 公共参数 ###公共参数 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | orgIdnonce | 企业ID6位随机字符串 | body | falsetrue | string | | | appInstanceIdtimestamp | 应用实例ID | body | false | long | | | openids | 身份识别标识集合 | body | false | array | [身份识别标识](#身份识别标识) | | phoneList | 手机号码列表 | body | false | array | [手机号码](#手机号码) | | audienceUserId | 客户档案ID | body | falseunix时间戳(毫秒) | body | true | long | | | point | 积分变动值 | body | true | int | | | remark | 备注 | body | true | string | | | eventType | 行为类型 | body | false | string | | | avatar | 用户头像 | body | false | string | | | nickName | 用户昵称 | body | false | string | | | contentId | 内容ID | body | false | string | | | contentName | 内容名称 | body | false | string | | | ext | 扩展信息 | body | false | string | | ### 身份识别标识 | ###用户增加积分信息 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | openidaudienceUserId | 用户ID | body | false | stringLong | | | unionidthirdId | 第三方用户ID | body | false | stringString | | | fromTopoint | 应用类型(contentminiapp:小程序, workwechat:企业微信外部联系人, gzh:公众号, workwechatgroup:客户群) 积分增加值 | body | false true| stringInteger | | | appidremark | 应用ID备注 | body | false true| stringString | | | jcappideventType | 系统集成应用实例ID行为类型 | body | false | longString | | | identityId | 身份识别类型ID | body | false | string | | | identityTyperelateBizCode | 身份识别类型(phone: 手机号码, id: 第三方用户ID, openid: 公众号openid, unionid: 开放平台unionid) 关联业务编码 | body | false | stringString | | ### 手机号码 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | phone | 手机号 | body | false | string | | | isVerify | 是否验证(0:未验证, 1:已验证) | body | false | string | | ### 请求示例 ###请求示例 ```json { "appInstanceId": 0, "audienceUserIdsaudienceUserId": [860484273911119872], "avatar": "", "contentId": "内容ID", "contentName": "内容明细", "eventType": "test", "extnonce": "123456", "nickNameorgId": "用户昵称", "openidspoint": [ { "appid": ""10, "fromTorelateBizCode": "业务编码", "identityIdremark": "测试增加", "identityTypethirdId": "", "jcappidtimestamp": 0, "openid": "", "unionid": "" } ], "orgId": "d515fa4b-8def-4188-8415-92632581795c", "phoneList": [ { "isVerify": "", "phone": "" } ], "point": 10, "remark": "积分自建应用测试" } ``` # 响应参数#响应参数 *** | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | code | 状态码 | body | true | string | | | errorCode | 异常码 | body | true | string | | | msg | 描述 | body | true | string | | | data | 操作是否成功用户积分是否增加成功 | body | true | boolean | | ### 响应状态###响应状态 | 状态码 | 说明 | schema | | ------ | ------ | ------ | | 200 | OK | | | 201 | Created | | | 401 | Unauthorized | | | 403 | Forbidden | | | 404 | Not Found | | ### 响应示例 ###响应示例 ```json { "code": "200", "errorCode": "SUCCESS", "msg": "ok", "data": true } ``` |
...