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

taobao.game.nft.distribution.callback (数字藏品发放结果回调)

数字藏品发放结果回调

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
app_id String 必须 12131313 区块链租户ID
nft_general_resp NftGeneralResp 必须 通用返回结果
  • └ ext_attribute
  • String
  • 可选
  • JSON 字符串
  • 扩展字段
  • nft_info_list
  • NftInfo []
  • 可选
  • 数字藏品列表
  • └ sku_name
  • String
  • 可选
  • 敦煌图
  • 数字藏品名称
  • └ date
  • String
  • 可选
  • yyyy-MM-dd HH:mm:ss
  • 发放时间
  • └ ext_attribute
  • String
  • 可选
  • JSON 字符串
  • 扩展字段
  • └ blockchain_type
  • Number
  • 可选
  • 113113
  • 区块链类型
  • └ author_name
  • String
  • 可选
  • XX创作者
  • 创作者名称
  • └ issuer_name
  • String
  • 可选
  • XX发行方
  • 发行方名称
  • └ producer_name
  • String
  • 可选
  • XX监制方
  • 监制方名称
  • └ nft_id
  • String
  • 可选
  • #A2D42DS
  • 数字藏品唯一编码
  • └ mini_image_path
  • String
  • 可选
  • 图片地址
  • 缩略图地址
  • └ sku_description
  • String
  • 可选
  • 简介
  • 数字藏品简介
  • └ sku_id
  • String
  • 可选
  • 13131313
  • 数字藏品类型ID
  • └ hash_code
  • String
  • 可选
  • sd131321ee3233
  • 交易hash
  • └ nft_show_code
  • String
  • 可选
  • tmallTest#001/100
  • nft定制展示编码
  • └ order_id
  • String
  • 必须
  • 134334
  • 订单流水ID
  • └ error_message
  • String
  • 可选
  • 成功
  • 错误信息
  • └ error_number
  • String
  • 可选
  • 0000
  • 错误码
  • └ inventory
  • String
  • 可选
  • 21
  • 库存
  • └ coop_status
  • String
  • 必须
  • UNDERWAY
  • 发放状态
  • └ is_success
  • Boolean
  • 可选
  • true
  • 是否成功

响应参数

名称 类型 示例值 描述
ext_attribute String JSON 字符串 扩展字段
nft_info_list NftInfo [] 数字藏品列表
  • └ sku_name
  • String
  • 敦煌图
  • 数字藏品名称
  • └ date
  • String
  • yyyy-MM-dd HH:mm:ss
  • 发放时间
  • └ ext_attribute
  • String
  • JSON 字符串
  • 扩展字段
  • └ blockchain_type
  • Number
  • 13131
  • 区块链类型
  • └ author_name
  • String
  • XX创作者
  • 创作者名称
  • └ issuer_name
  • String
  • XX发行方
  • 发行方名称
  • └ producer_name
  • String
  • XX监制方
  • 监制方名称
  • └ nft_id
  • String
  • #A4F32
  • 数字藏品唯一编码
  • └ mini_image_path
  • String
  • 图片地址
  • 缩略图地址
  • └ sku_description
  • String
  • 简介
  • 藏品简介
  • └ sku_id
  • String
  • 131131313
  • 数字藏品类型ID
  • └ hash_code
  • String
  • s121we3
  • 交易hash
  • └ nft_show_code
  • String
  • tmallTest#001/100
  • nft定制展示编码
order_id String 2424244 订单号
error_message String 成功 错误信息
error_number String 0000 错误码
inventory String 10 库存
coop_status String SUCCESS 发放状态
is_success Boolean true 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
GameNftDistributionCallbackRequest req = new GameNftDistributionCallbackRequest();
req.setAppId("12131313");
GameNftDistributionCallbackRequest.NftGeneralResp obj1 = new GameNftDistributionCallbackRequest.NftGeneralResp();
obj1.setExtAttribute("JSON 字符串");
List<GameNftDistributionCallbackRequest.NftInfo> list3 = new ArrayList<GameNftDistributionCallbackRequest.NftInfo>();
GameNftDistributionCallbackRequest.NftInfo obj4 = new GameNftDistributionCallbackRequest.NftInfo();
list3.add(obj4);
obj4.setSkuName("敦煌图");
obj4.setDate("yyyy-MM-dd HH:mm:ss");
obj4.setExtAttribute("JSON 字符串");
obj4.setBlockchainType(113113L);
obj4.setAuthorName("XX创作者");
obj4.setIssuerName("XX发行方");
obj4.setProducerName("XX监制方");
obj4.setNftId("#A2D42DS");
obj4.setMiniImagePath("图片地址");
obj4.setSkuDescription("简介");
obj4.setSkuId("13131313");
obj4.setHashCode("sd131321ee3233");
obj4.setNftShowCode("tmallTest#001/100");
obj1.setNftInfoList(list3);
obj1.setOrderId("134334");
obj1.setErrorMessage("成功");
obj1.setErrorNumber("0000");
obj1.setInventory("21");
obj1.setCoopStatus("UNDERWAY");
obj1.setIsSuccess(true);
req.setNftGeneralResp(obj1);
GameNftDistributionCallbackResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<game_nft_distribution_callback_response>
    <ext_attribute>JSON 字符串</ext_attribute>
    <nft_info_list>
        <nft_info>
            <sku_name>敦煌图</sku_name>
            <date>yyyy-MM-dd HH:mm:ss</date>
            <ext_attribute>JSON 字符串</ext_attribute>
            <blockchain_type>13131</blockchain_type>
            <author_name>XX创作者</author_name>
            <issuer_name>XX发行方</issuer_name>
            <producer_name>XX监制方</producer_name>
            <nft_id>#A4F32</nft_id>
            <mini_image_path>图片地址</mini_image_path>
            <sku_description>简介</sku_description>
            <sku_id>131131313</sku_id>
            <hash_code>s121we3</hash_code>
            <nft_show_code>tmallTest#001/100</nft_show_code>
        </nft_info>
    </nft_info_list>
    <order_id>2424244</order_id>
    <error_message>成功</error_message>
    <error_number>0000</error_number>
    <inventory>10</inventory>
    <coop_status>SUCCESS</coop_status>
    <is_success>true</is_success>
</game_nft_distribution_callback_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部