host

1. 获取一个免登地址

每次请求获取一个免登页面的链接，把返回结果的 freeLoginUrl 放入 iframe src 即可。

请求路径

  • http://{host}/api/{corp_id}/third/login

请求方法

  • get

headers

字段名 类型 必填 说明
access-token String true access-token

请求参数:

字段名 类型 必填 说明
code String true thirdUserId，第三方系统用户唯一id
corpId String false 企业corpId
loginSource String false app端对接时需要传值：skb_isv_app
sign String true 登录签名，签名算法：sign=md5(code+secret)
url String false 按下面表格的【url入参】请求对应页面的url ，下面有效果图
PC端/手机端 url 入参 页面菜单的默认名称
PC端 /soukebox/search_home 找企业
PC端 /soukebox/advanced_search 高级搜索
PC端 /soukebox/batch_search 批量查询
PC端 /soukebox/map 地图获客
PC端 /soukebox/recommend 智能推荐
PC端 /soukebox/soukebox/{{id}} 线索详情
PC端 /soukebox/management 额度设置
PC端 /new_report_center#/skb/limit/consume_stats 流量额度统计
APP端 #/skb/find-corp 找企业
APP端 #/skb/map 地图获客

返回格式:

{
    "code":0,
    "message":"success",
    "requestId":"267012784EAC450E9ECB6B8BA0073978",
    "data":{
        "corpId":"",
        "expired": true,  // 标记用户是否过期（当用户已过期时，建议对接方不要再跳转到freeLoginUrl（此时freeLoginUrl跳转到的是一个通用的报错页面），可以跳转到自己自定义的过期提示页面）
        "freeLoginUrl":"https://uc-dev.weiwenjia.com/web/index.html?originPlatform=skb&redirect_uri=https%3A%2F%2Fuc-dev.weiwenjia.com%2Fapi%2FwwjtRkt02c9kCoSgE2mh%2FloginCallback%3Fplatform%3DwwjtRkt02c9kCoSgE2mh%26token%3D5be5fef875af45d99c977a7e67858c1b%26code%3D3333%26status%3D1%26corpId%3DwwjtRkt02c9kCoSgE2mh%26appToken%3Df6620ff6729345c8b6101174e695d0ab%26url%3D%252Fpioneers%2523%252Fdetail-page%252F2500002%252Fbase%252Fdetail%253Fmodule%253Dcontract#/adapter",   // 跳转url
    }
}

异常示例

h5地图获客特殊处理

为了获取精准的定位，进去地图获客页面，前端会抛出事件：

window.parent.postMessage({ type: 'REQUEST_CURRENTPOSITION'}, "*")

需要接入方在获取到“REQUEST_CURRENTPOSITION”事件之后，抛回事件，约定
event.data.type：RESPONSE_CURRENTPOSITION
event.data.data：{longitude:”经度”, latitude:”纬度”}

文档更新时间: 2026-06-24 13:31   作者：004