一、给企业开通试用账号

1.开通API接口配置

  • 测试环境host：bms-test.weiwenjia.com
  • 生产环境host：bfs.lingxiaodata.com
  • access-token
  • secret
    需要对接方需提供信息： 企业名称、业务对接人姓名、手机号、邮箱。
    （请联系业务负责人开通服务商后台（用于订单和充值管理），邮件发送给您。）

2. 注册试用企业

请求路径

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

请求方法

  • post

headers

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

请求包体

字段名 类型 必填 说明
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)

注：请求是json格式，header中Content-Type: application/json：
请求参数示例：

{
  "company_name": "xx",
  "account_name": "xxx",
  "account_no": "adminxx5",
  "account_pw": "xxxx",
  "sign": "xx"
}

返回格式:

{
    "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"  // 企业过期时间
    }
}

二、给企业提单开通付费账号

1. 获取套餐规格

请求路径

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

请求方法

  • get

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": "10000.00"
        },
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "20万额度/20工号/年",
            "amount": "20000.00"
        },
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "增购5工号",
            "amount": "1000.00"
        },
        {
            "package_no": "CP00xxxxxxxxxxxx",
            "package_name": "增购10万条线索额度",
            "amount": "10000.00"
        }
    ]
}

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 产品套餐编号（在上面的【获取套餐规格】接口获得）
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。默认关闭

注：请求是json格式，header中Content-Type: application/json：
请求参数示例：

{
  "corp_id": "xx",
  "order_no": "xxx",
  "package_no": "adminxx5",
  "sign": "xxxx",
  "started_at": "xxxx",
  "llb_monthly_cap": "xxxx"
}

套餐信息

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

套餐编号（测试环境） 名称 月查上限 备注说明
CP00144_0003_01 试用1000额度/5工号/7天 - 不需要提单，注册企业时已经默认开通
CP001xxx 20工号20w额度1年 2w 这是基础套餐规格，第一次购买是新开；再次购买是续费，只续期不增加额度
CP002xxx 增购10万条线索额度 - 这是增量规格，每次购买只增加额度，不延长到期时间
CP003xxx 增购5工号 - 这是增量规格，每次购买只增加工号数量，不延长到期时间

返回格式:

{
    "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"
    }
}
文档更新时间: 2026-06-24 13:31   作者：004