文档中心 > API类目 > 淘宝游戏API

qimen.taobao.game.nft.distribute (数字藏品发放接口)

淘宝数字藏品发放接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
appParam String 可选 JSON 字符串格式 区块链租户参数
blockchainType String 必须 1111111 区块链类型
skuId String 必须 12345 NFT类型id
orderId String 必须 123455 发放流水id
orderNum String 必须 1 NFT发放数量
account String 必须 手机号 接收账号
extAttr String 可选 JSON 字符串 方便扩展其余业务参数
appId String 必须 ohwsda2e1da 区块链租户id

响应参数

名称 类型 示例值 描述
resultCode String 1010 接口错误码
resultMsg String 失败,请勿重试 接口错误信息
errCode String 0000 业务错误码
errMsg String 成功 业务错误信息
orderId String 2313131 发放流水号
coopStatus String UNDERWAY 发放状态三种:SUCCESS、UNDERWAY、FAILED
nftInfoList NftInfo [] 数字藏品列表
  • └ blockchainType
  • String
  • 221212
  • 区块链类型
  • └ skuId
  • String
  • 13131
  • 数字藏品类型 id
  • └ skuName
  • String
  • 敦煌图
  • 藏品名称
  • └ nftId
  • String
  • #AS12DS
  • 数字藏品唯一编码
  • └ authorName
  • String
  • XX创作者
  • 创作者名称
  • └ issuerName
  • String
  • XX发行方
  • 发行方名称
  • └ miniImagePath
  • String
  • 图片地址
  • 缩略图地址
  • └ date
  • String
  • yyyy-MM-dd HH:mm:ss
  • 发放时间
  • └ extAttr
  • String
  • JSON 字符串
  • 扩展字段,扩展业务参数
  • └ skuDescription
  • String
  • 数字藏品简介
  • 数字藏品简介
  • └ producerName
  • String
  • XX监制方
  • 监制方名称
  • └ hashCode
  • String
  • 649317795371184e391a1f9ee4fb846fbf377b437fd300c2c5dadfc8cd4642993d811c1635e
  • 交易hash
  • └ nftShowCode
  • String
  • tmallTest#001/100
  • nft定制展示编码

请求示例

{"appParam":"JSON 字符串格式","orderId":"123455","blockchainType":"1111111","appId":"ohwsda2e1da","orderNum":"1","skuId":"12345","account":"手机号","extAttr":"JSON 字符串"}

响应示例

{
    "resultCode":"1010",
    "resultMsg":"失败,请勿重试",
    "errCode":"0000",
    "errMsg":"成功",
    "orderId":"2313131",
    "coopStatus":"UNDERWAY",
    "nftInfoList":[
        {
                "blockchainType":"221212",
                "skuId":"13131",
                "skuName":"敦煌图",
                "nftId":"#AS12DS",
                "authorName":"XX创作者",
                "issuerName":"XX发行方",
                "miniImagePath":"图片地址",
                "date":"yyyy-MM-dd HH:mm:ss",
                "extAttr":"JSON 字符串",
                "skuDescription":"数字藏品简介",
                "producerName":"XX监制方",
                "hashCode":"649317795371184e391a1f9ee4fb846fbf377b437fd300c2c5dadfc8cd4642993d811c1635e",
                "nftShowCode":"tmallTest#001\/100"
        }
    ]
}

验签示例

{"errCode":"sign-check-failure","resultCode":"-1","errMsg":"Illegal request"}

错误码解释

错误码 错误描述 解决方案
response-body-parse-error

API工具

FAQ

返回
顶部