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 账号
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": "xxxxxx",
        "corp_id": "wwjPllTve5zHeS5Fxxxe",
        "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天，默认当天开通。

套餐信息

套餐编号（测试环境） 名称 价格（元）
CP00144_0003_01 试用 0
CP00144_0002_01 20工号20w额度1年 1500
CP00145_0002_01 加10w额度 700
—————– —— —-
套餐编号（正式环境） 名称 价格（元）
CP00134_0001_01 试用 0
CP00134_0007_01 年查20万额度/20工号
CP00134_0006_01 年查50万额度/20工号
CP00134_0005_01 年查100万额度/20工号
CP00134_0004_01 年查200万额度/20工号
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 推送数据给服务商的地址
additional_config_url String false 获取服务商数据推送配置信息的地址
sign String true 签名，签名算法：sign=md5(corp_id+sync_url+additional_config_url+secret)

返回格式:

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

错误码说明

错误码（code） 错误说明
400 参数错误
404 企业不存在
500 系统异常或其他错误
文档更新时间: 2025-11-04 09:32   作者：胡进