cn.felord.reactive.api

Interface UpStreamApi

public interface UpStreamApi

上下游-上游调用

Since:

2024/10/12

Author:

dax

Method Summary

Modifier and Type	Method and Description
io.reactivex.rxjava3.core.Single<GenericResponse<List<PendingExUser>>>	externalUseridToPendingId(ExPendingIdRequest request) external_userid查询pending_id (上游专用) 调用该接口的应用必须是上下游共享的自建应用或代开发应用 应用需要具有客户联系权限 该客户的跟进人或其所在客户群群主必须在应用的可见范围之内 上游应用须调用过unionidToPendingId(UnionPendingIdRequest) 上游和下游企业须认证或验证；若为代开发应用，服务商必须已认证
io.reactivex.rxjava3.core.Single<GenericResponse<String>>	getChainCorpinfo(ChainContactRequest request) 提交批量导入上下游联系人任务 仅已验证的企业可调用 仅上下游系统应用可调用 同时只能存在一个导入任务。导入任务包括通过API提交的任务和从管理后台提交的导入任务。
io.reactivex.rxjava3.core.Single<ChainCorpDetailResponse>	getChainCorpinfo(ChainCorpDetailRequest request) 获取企业上下游通讯录下的企业信息
io.reactivex.rxjava3.core.Single<GroupCorpsResponse>	getChainCorpinfoList(ChainGroupInfoRequest request) 获取企业上下游通讯录分组下的企业详情列表
io.reactivex.rxjava3.core.Single<GenericResponse<List<ChainGroup>>>	getChainGroup(ChainGroupRequest request) 获取上下游通讯录分组
io.reactivex.rxjava3.core.Single<GenericResponse<List<ChainCorp>>>	getChainList() 获取上下游列表 自建应用/代开发应用可调用，仅返回应用可见范围内的上下游列表 上下游系统应用可调用，返回全部的上下游列表
io.reactivex.rxjava3.core.Single<GenericResponse<List<ChainCorp>>>	getChainUserCustomId(CorpId corpId) 获取下级企业加入的上下游
io.reactivex.rxjava3.core.Single<GenericResponse<String>>	getChainUserCustomId(CorpInUser user) 查询成员自定义id
io.reactivex.rxjava3.core.Single<JobResultResponse>	getResult(String jobId) 获取异步任务结果
io.reactivex.rxjava3.core.Single<ShareInfoResponse>	listAppShareInfo(ShareInfoRequest request) 获取应用共享信息
io.reactivex.rxjava3.core.Single<WeComResponse>	removeCorp(ChainCorpDetailRequest request) 移除企业
io.reactivex.rxjava3.core.Single<GenericResponse<List<CorpExUser>>>	unionidToExternalUserid(CorpExUserRequest request) 上下游关联客户信息-已添加客户
io.reactivex.rxjava3.core.Single<GenericResponse<String>>	unionidToPendingId(UnionPendingIdRequest request) unionid查询pending_id

Method Detail

listAppShareInfo

@POST(value="corpgroup/corp/list_app_share_info")
io.reactivex.rxjava3.core.Single<ShareInfoResponse> listAppShareInfo(@Body
                                                                                                                       ShareInfoRequest request)

获取应用共享信息

局校互联中的局端或者上下游中的上游企业通过该接口可以获取某个应用分享给的所有企业列表。 特别注意，对于有敏感权限的应用，需要下级/下游企业确认后才能共享成功，若下级/下游企业未确认，则不会存在于该接口的返回列表

Parameters:

request - the request

Returns:

the share info response

unionidToExternalUserid

@POST(value="corpgroup/unionid_to_external_userid")
io.reactivex.rxjava3.core.Single<GenericResponse<List<CorpExUser>>> unionidToExternalUserid(@Body
                                                                                                                                                CorpExUserRequest request)

上下游关联客户信息-已添加客户

场景：品牌在公众号、小程序上的微信粉丝，可以跟经销商用企微添加的微信客户打通数据

实现效果：共享客户信息，完善客户画像，促进成交

准备工作

• 品牌有自己主体（或isv主体）的公众号、小程序
• 品牌创建上下游，经销商新建企业并加入上下游
• 品牌共享应用给经销商
• 经销商管理员授权应用获取「企业客户」权限

Parameters:

request - the request

Returns:

the generic response

unionidToPendingId

@POST(value="corpgroup/unionid_to_pending_id")
io.reactivex.rxjava3.core.Single<GenericResponse<String>> unionidToPendingId(@Body
                                                                                                                            UnionPendingIdRequest request)

unionid查询pending_id

该接口有调用频率限制，按上游企业维度，限制为：10万次/小时、48万次/天、750万次/月。

1. 调用该接口的应用必须是上下游共享的自建应用或代开发应用
2. 应用需要具有客户联系权限
3. 当前授权企业必须已认证或已验证；若为代开发应用，服务商必须已认证
4. unionid（即微信开放平台账号主体）与openid（即小程序或服务号账号主体）需要认证，且主体名称需与上游企业的主体名称一致（查看由服务商代注册的开放平台账号认证流程）
5. openid与unionid必须是在同一个小程序获取到的

pending_id的说明

• pending_id主要用于关联微信unionid与外部联系人external_userid，可理解为临时外部联系人ID；
• 上游企业可通过此接口将微信unionid转为pending_id，当微信用户成为下游企业客户后，可使用上下游external_userid转pending_id接口将下游external_userid转换为pending_id，建立unionid 到 pending_id 再到 external_userid的映射关系；
• pending_id有效期90天，共享应用内唯一。

Parameters:

request - the request

Returns:

the generic response

externalUseridToPendingId

@POST(value="corpgroup/batch/external_userid_to_pending_id")
io.reactivex.rxjava3.core.Single<GenericResponse<List<PendingExUser>>> externalUseridToPendingId(@Body
                                                                                                                                                              ExPendingIdRequest request)

external_userid查询pending_id (上游专用)

• 调用该接口的应用必须是上下游共享的自建应用或代开发应用
• 应用需要具有客户联系权限
• 该客户的跟进人或其所在客户群群主必须在应用的可见范围之内
• 上游应用须调用过unionidToPendingId(UnionPendingIdRequest)
• 上游和下游企业须认证或验证；若为代开发应用，服务商必须已认证

Parameters:

request - the request

Returns:

the generic response

See Also:

下游专用

getChainList

@GET(value="corpgroup/corp/get_chain_list")
io.reactivex.rxjava3.core.Single<GenericResponse<List<ChainCorp>>> getChainList()

获取上下游列表

• 自建应用/代开发应用可调用，仅返回应用可见范围内的上下游列表
• 上下游系统应用可调用，返回全部的上下游列表

Returns:

the chain list

getChainGroup

@POST(value="corpgroup/corp/get_chain_group")
io.reactivex.rxjava3.core.Single<GenericResponse<List<ChainGroup>>> getChainGroup(@Body
                                                                                                                                ChainGroupRequest request)

获取上下游通讯录分组

自建应用/代开发应用和上下游系统应用可通过该接口获取企业上下游通讯录分组详情

• 自建应用/代开发应用可调用，仅可指定或返回应用可见范围内的分组列表
• 上下游系统应用可调用，可指定或返回全部的分组列表

Parameters:

request - the request

Returns:

the chain group

getChainCorpinfoList

@POST(value="corpgroup/corp/get_chain_corpinfo_list")
io.reactivex.rxjava3.core.Single<GroupCorpsResponse> getChainCorpinfoList(@Body
                                                                                                                                ChainGroupInfoRequest request)

获取企业上下游通讯录分组下的企业详情列表

自建应用/代开发应用和上下游系统应用可通过该接口获取企业上下游通讯录的某个分组下的企业列表

如需获取该分组及其子分组的所有企业详情，需先获取该分组下的所有子分组，然后再获取子分组下的企业，逐层递归获取。

Parameters:

request - the request

Returns:

the chain corpinfo list

getChainCorpinfo

@POST(value="corpgroup/corp/get_chain_corpinfo")
io.reactivex.rxjava3.core.Single<ChainCorpDetailResponse> getChainCorpinfo(@Body
                                                                                                                            ChainCorpDetailRequest request)

获取企业上下游通讯录下的企业信息

自建应用/代开发应用和上下游系统应用可通过该接口获取企业上下游通讯录的某个企业的自定义id和所属分组的分组id

• 自建应用/代开发应用可调用，仅可指定应用可见范围内的企业
• 上下游系统应用可调用，可指定上下游内的所有企业

Parameters:

request - the request

Returns:

the chain corpinfo

getChainCorpinfo

@POST(value="corpgroup/import_chain_contact")
io.reactivex.rxjava3.core.Single<GenericResponse<String>> getChainCorpinfo(@Body
                                                                                                                         ChainContactRequest request)

提交批量导入上下游联系人任务

• 仅已验证的企业可调用
• 仅上下游系统应用可调用

同时只能存在一个导入任务。导入任务包括通过API提交的任务和从管理后台提交的导入任务。

Parameters:

request - the request

Returns:

the chain corpinfo

getResult

@GET(value="corpgroup/getresult")
io.reactivex.rxjava3.core.Single<JobResultResponse> getResult(@Query(value="jobid")
                                                                                                String jobId)

获取异步任务结果

只能查询已经提交过的历史任务。

并发限制：5

Parameters:

jobId - the job id

Returns:

the result

removeCorp

@POST(value="corpgroup/corp/remove_corp")
io.reactivex.rxjava3.core.Single<WeComResponse> removeCorp(@Body
                                                                                                     ChainCorpDetailRequest request)

移除企业

上级/上游企业通过该接口移除下游企业

• 仅已验证的企业可调用
• 仅上下游系统应用可调用

Parameters:

request - the request

Returns:

the we com response

getChainUserCustomId

@POST(value="corpgroup/corp/get_chain_user_custom_id")
io.reactivex.rxjava3.core.Single<GenericResponse<String>> getChainUserCustomId(@Body
                                                                                                                                      CorpInUser user)

查询成员自定义id

上级企业自建应用/代开发应用通过本接口查询成员自定义 id

自建应用、代开发应用和「上下游」原生应用可调用，仅可指定应用可见范围内的企业

Parameters:

user - the user

Returns:

the generic response

getChainUserCustomId

@POST(value="corpgroup/corp/get_chain_user_custom_id")
io.reactivex.rxjava3.core.Single<GenericResponse<List<ChainCorp>>> getChainUserCustomId(@Body
                                                                                                                                               CorpId corpId)

获取下级企业加入的上下游

上级企业自建应用/代开发应用通过本接口查询下级企业所在上下游

自建应用、代开发应用和「上下游」原生应用可调用，仅可指定应用可见范围内的企业

Parameters:

corpId - the corp id

Returns:

the chain user custom id