host

  • 测试环境：bms-test.weiwenjia.com
  • 生产环境：bms.weiwenjia.com（通用版），bfs.lingxiaodata.com（定制版）

配置信息

  • access-token
  • secret
    （access-token和secret，由ISV负责人开通bms服务商后自动生成，并以邮件方式发送给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/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。默认关闭

套餐信息

套餐编号（测试环境） 名称 月查上限 价格（元）
注册企业后默认开通 试用1000额度/20工号/3天 - -
CP00144_0002_01 20工号20w额度1年 2w -
CP00145_0002_01 加10w额度 - -
—————– —— —-
套餐编号（正式环境） 名称 月查上限 价格（元）
注册企业后默认开通 试用1000额度/20工号/3天 - -
CP00134_0007_01 年查20万额度/20工号 2w -
CP00134_0006_01 年查50万额度/20工号 5w -
CP00134_0005_01 年查100万额度/20工号 10w -
CP00134_0004_01 年查200万额度/20工号 20w -
CP00134_0003_01 增加5工号 - -
CP00135_0002_01 增加10万额度 - -

返回格式:

{
    "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"
    }
}

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

请求路径

  • 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 系统异常或其他错误
文档更新时间: 2025-12-02 17:30   作者：胡进