企业对接接口 - Powered by MinDoc

host

测试环境：bms-test.weiwenjia.com
生产环境：bfs.lingxiaodata.com

配置信息

access-token
secret
（access-token和secret，由ISV负责人线下沟通后开通服务商后台（用于订单管理），并以邮件方式发送给ISV服务商。）
对接方需提供的信息：企业名称、联系人、手机号

1. 注册试用企业

请求路径

https://{host}/api/v1/skb_isvs/create_client

请求方法

post

headers

字段名	类型	必填	说明
Authorization	String	true	{ Authorization: Token token=”#{ access-token }” }

请求包体

字段名	类型	必填	说明
company_name	String	true	公司名称
account_name	String	true	用户姓名
account_no	String	true	third_user_id，第三方系统用户‘唯一’id，会作为企业的创建人账号，权限最高
account_pw	String	true	密码
sign	String	true	签名，签名算法：sign=md5(company_name+account_name+account_no+secret)

返回格式:

{
    "code": 200,
    "message": "成功",
    "time_at": "2025-04-16 16:29:25",
    "data": {
        "oid": "登录企业的唯一编号",  // 搜客宝企业唯一id
        "corp_id": "wwjPllTve5zHeS5Fxxxe",  // 搜客宝企业唯一id（订单系统标识id）
        "uid": "登录企业的第一个创建人唯一编号",  // 搜客宝用户唯一id
        "expired_at": "2026-04-16 23:59:59"  // 企业过期时间
    }
}

2. 获取套餐规格

请求路径

https://{host}/api/v1/skb_isvs/get_packages

请求方法

headers

字段名	类型	必填	说明
Authorization	String	true	{ Authorization: Token token=”#{ access-token }” }

返回格式:

{
    "code": 200,
    "message": "成功",
    "time_at": "2026-05-17 11:46:37",
    "data": [
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "年查10万额度/20工号",
            "amount": "100.0"
        },
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "年查50万额度/20工号",
            "amount": "200.0"
        },
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "年查100万额度/20工号",
            "amount": "300.0"
        },
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "增购5工号",
            "amount": "100.0"
        },
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "增购10万条线索额度",
            "amount": "500.0"
        }
    ]
}

3. 企业付费提单

请求路径

https://{host}/api/v1/skb_isvs/create_order

请求方法

post

headers

字段名	类型	必填	说明
Authorization	String	true	{ Authorization: Token token=”#{ access-token }” }

请求包体

字段名	类型	必填	说明
corp_id	String	true	企业唯一编码
order_no	String	true	服务商自己平台的订单号
package_no	String	true	ISV产品套餐编号
sign	String	true	签名，签名算法：sign=md5(corp_id+order_no+package_no+secret)
started_at	String	false	指定开通时间（格式：2025-01-01），默认当天开通，也可设置提前开通但不得超过90天。
llb_monthly_cap	String	false	月查上限，开启：open，关闭：close。默认关闭

套餐信息

注意：生产环境正式套餐，请通过上面“2. 获取套餐规格”接口查询。

套餐编号（测试环境）	名称	月查上限	价格（元）
注册企业后默认开通	试用1000额度	-	-
CP00144_0002_01	20工号20w额度1年	2w	-
CP00145_0002_01	加10w额度	-	-

返回格式:

{
    "code": 200,
    "message": "成功",
    "time_at": "2025-04-16 16:29:25",
    "data": {
        "oid": "xxxxxx",
        "corp_id": "wwjPllTve5zHeS5Fxxxe",
        "expired_at": "2026-04-16 23:59:59",
        "number": "DD20250101385302"
    }
}

4. 设置数据同步推送地址

请求路径

https://{host}/api/v1/skb_isvs/update_isv_conf

请求方法

post

headers

字段名	类型	必填	说明
Authorization	String	true	{ Authorization: Token token=”#{ access-token }” }

请求包体

字段名	类型	必填	说明
corp_id	String	true	企业唯一编码
sync_url	String	true	批量转线索，推送数据给服务商的地址
single_sync_url	String	false	单条转线索，推送数据给服务商的地址（未配置时线索详情没有单条转移的按钮）
additional_config_url	String	false	获取服务商数据推送配置信息的地址
sign	String	true	签名，签名算法：sign=md5(corp_id+sync_url+single_sync_url+additional_config_url+secret)

返回格式:

{
    "code": 200,
    "message": "成功",
    "time_at": "2025-04-16 16:29:25",
}

错误码说明

错误码（code）	错误说明
400	参数错误
404	企业不存在
500	系统异常或其他错误

文档更新时间: 2026-05-18 10:13 作者：004