1、资产导入时序图

时序图

2、术语

接入方：用户资产的外部所有者

平台方：数源卡包

所属链：资产所在的区块链

3、生成签名

使用对接方的corp_secret对Url查询参数进行HMACSHA256签名

step1 生成公共请求参数(UTC时间戳、nonce随机6位非0开头正整数、corp_id)

step2 将请求数据格式化为Url查询参数的形式

step3 对Url查询参数按照字母升序排列

step4 进行一次UrlEncode后，使用corp_secret对UrlEncode的字符串签名，生成hex字符串

step5 将&sign=签名字符串追加在UrlEncode后的字符串尾部，即可获得完整的Url查询参数

代码示例

GET https://out.xxxxx.com/assets/account/verification

以请求验证用户账号为例（Golang Function）

func SignByUrl(corpSecret string, query *url.Values) (string, string, error) {
    queryStr := query.Encode()

    hash := hmac.New(sha256.New, []byte(corpSecret))
    _, err := hash.Write([]byte(queryStr))
    if err != nil {
        return "", "", err
    }
    signData := hash.Sum(nil)
    signature := hex.EncodeToString(signData)
    queryStr = fmt.Sprintf("%s&sign=%s", queryStr, signature)
    return queryStr, signature, nil
}

func DoRequest() {
    domain := "https://out.xxxxx.com/assets/single/importing"
    corpId := "wn9ybdkn78z33x9fsbu4cu63ft6gnf7m"
    corpSecret := "9eysdhsal1212knmo358sdd"
    account := "18690706666"

    query := &url.Values{}
    query.Add("account", account)
    
    // 增加默认字段
    timestamp := uint64(time.Now().UTC().Unix())
    nonce := rand.Intn(800000) + 100000
    
    query.Add("corp_id", corpId)
    query.Add("nonce", strconv.Itoa(nonce))
    query.Add("timestamp", strconv.FormatUint(timestamp, 10))
    queryStr, _, err := SignByUrl(corpSecret, query)
    if err != nil {
        return
    }

    reqUrl := fmt.Sprintf("%s?%s", domain, queryStr)

    req, _ := http.NewRequest("GET", reqUrl, nil)
    req.Header.Add("Content-Type", "application/json")
  
    client := &http.Client{}
    defer client.CloseIdleConnections()
    resp, err := client.Do(req)
  
    if err != nil {
        fmt.Println(err)
        return
    }
    defer resp.Body.Close()
  
    var buf bytes.Buffer
    _, err = buf.ReadFrom(resp.Body)
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(buf.String())
}

4、API列表

(1) 用户账号验证

(2) 处理资产单笔导入

(3) 处理资产批量导入

(4) 导入结果回调

(1) 用户账号验证

调用接入方已登记的用户账号验证接口

基本信息

请求方式：GET

请求地址：https://out.xxxxx.com/assets/account/verification

Query参数

返回参数

(2) 请求资产单笔导入

调用接入方已登记的资产单笔导入接口

基本信息

请求方式：GET

请求地址：https://out.xxxxx.com/assets/single/importing

Query参数

返回参数

(3) 请求资产批量导入

调用接入方已登记的资产批量导入接口

基本信息

请求方式：GET

请求地址：https://out.xxxxx.com/assets/batch/importing

Query参数

返回参数

(4) 导入结果回调

接入方在转账成功后，调用平台方的回调接口

基本信息

请求方式：GET

请求地址：https://out.xxxxx.com/assets/importing/callback

Query参数

返回参数

5、状态码列表

当code值不等于200时，返回数据的data为null，并且msg有错误提示信息