开通主体

# 开通熵基智联

第三方平台，在熵基智联开发者中心创建的应用，通过上架审核后，才可以开通熵基智联。

开通熵基智联，即创建主体（学校），是开启双方平台业务集成的关键的第1步。

接口地址： https://api.zkbiocloud.com/open/edu/school/basic/v1/unit/open?appKey=xxx&timestamp=xxx&nonce=xxx&sign=xxx

属性名称	属性描述	类型	是否必填	备注
appKey	应用Key	String	是	开发者创建应用AppKey
timestamp	时间戳	Long	是	当前时间，Unix毫秒时间戳，用于防止请求重放攻击（时间戳有效期为5分钟）
nonce	随机数	String	是	8位长度字符串随机数，与timestamp结合使用，用于防止请求重放攻击
sign	签名	String	是	签名：MD5-32位小写（appKey + timestamp + nonce + appSecret）

请求方式： POST

请求包体：

{
    "payload": {
        "params": {
            "name": "熵基中学",
            "province": "福建省",
            "city": "厦门市",
            "county": "集美区",
            "address": "杏林街道诚毅北路B0221号",
            "zip": "361006",
            "email": "edu@zkteco.com",
            "phone": "15999999999",
            "logo": "https://www.zkteco.com/cn/uploads/image/20201020/b15348a71664dbb9f8714879ea28bd0d.png",
            "industry": "互联网",
            "subIndustry": "电子设备/计算机软件",
            "remark": "主体信息备注"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

入参说明

入参名称	入参类型	参数长度	必填	入参说明
name	String	100	是	主体名称
province	String	20	否	主体所属省份
city	String	20	否	主体所属城市
county	String	20	否	主体所属区县
address	String	100	否	详细地址
zip	String	20	否	邮政编码
email	String	32	否	联系人邮箱
phone	String	20	是	联系人电话
logo	String	255	否	logo url
industry	String	20	否	所属行业
subIndustry	String	100	否	子行业，用/分割
remark	String	255	否	备注信息

返回数据：

{
    "code": "00000000",
    "message": "主体已开通成功，请等待审核",
    "payload": {
        "results": {
            "unitId": "60a01ac4855d4fc1983e696b303e83ef",
            "secureCode": "5DGIPDWKGUZA3X1E"
        }
    }
}

1
2
3
4
5
6
7
8
9
10

返回参数说明：

属性名称	类型	属性描述
code	String	响应返回码
message	String	成功响应消息内容
unitId	String	主体ID（32位的uuid），需要第三方平台保存维护，与熵基智联业务对接需要用到，如：获取授权令牌
secureCode	String	主体安全码，需要第三方平台保存维护，与熵基智联业务对接需要用到，如：获取授权令牌

← 推送事件加解密关闭主体→