host

  • 测试环境：bms-test.weiwenjia.com
  • 生产环境：bms.weiwenjia.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)

套餐信息

套餐编号 名称 价格（元）
CP00144_0003_01 试用 0
CP00144_0002_01 20工号20w额度1年 1500
CP00145_0002_01 加10w额度 700

返回格式:

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

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-07-25 15:12   作者：胡进