区块积木

8.ERC721合约开启NFT盲盒

POST

https://testnet.jugugu.cn/GUGUBOX_OpenBlindBox

使用自定义的ERC721合约开启盲盒NFT

请求参数

Body 参数application/json

phone

string

手机号

必需

token

string

登录Jugugu获得的通信令牌

必需

contract

string

合约地址

必需

生成NFT的合约地址

name

string

NFT的名称

必需

description

string

NFT简介

必需

image

string

data Base64编码数据，数据大小<40Mb

必需

data:image/gif;base64,base64编码的gif图片数据 data:image/png;base64,base64编码的png图片数据 data:image/jpeg;base64,base64编码的jpeg图片数据 data:image/x-icon;base64,base64编码的icon图片数据 data:audio/mp3;base64,base64编码的mp3音频数据 data:video/mp4;base64,base64编码的mp4视频数据

extra_image

string

NFT额外的资源

必需

可以是图片、视频、音乐、PDF、3D模型文件。格式也需要base64编码。格式必须是data:image/gif;base64,base64编码的gif图片数据 data:image/png;base64,base64编码的png图片数据 data:image/jpeg;base64,base64编码的jpeg图片数据 data:image/x-icon;base64,base64编码的icon图片数据 data:audio/mp3;base64,base64编码的mp3音频数据 data:video/mp4;base64,base64编码的mp4视频数据

ids

array[string]

开启盲盒的NFT ID数组

必需

开启盲盒的NFT ID数组，长度小于10000

attributes

array [object {2}]

属性数组

必需

属性数组

trait_type

string

属性名称

必需

value

string

属性值

必需

示例

{
  "phone": "18116654355",
  "token": "sed",
  "contract": "sunt consectetur aliqua voluptate",
  "name": "亲高品风",
  "description": "必感细战么段质行听身型报口度得证。么况保实论住时造调合没方也权。长与往叫理论所七将目再高。理支区油除定热产红就过市始别。与并长革看看共铁外不划清采面大。百业思算局起制院果小说感三老于过九度。",
  "image": "http://dummyimage.com/400x400",
  "number": "90",
  "attributes": [
    {
      "trait_type": "pariatur et id non",
      "value": "deserunt eu laboris"
    },
    {
      "trait_type": "dolor sit proident in",
      "value": "officia Duis"
    },
    {
      "trait_type": "Duis et laborum labore",
      "value": "eu occaecat Ut culpa"
    },
    {
      "trait_type": "tempor eiusmod aliquip",
      "value": "consequat officia Excepteur nulla sit"
    }
  ],
  "code": "47"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://testnet.jugugu.cn/GUGUBOX_OpenBlindBox' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone": "18116654355",
    "token": "sed",
    "contract": "sunt consectetur aliqua voluptate",
    "name": "亲高品风",
    "description": "必感细战么段质行听身型报口度得证。么况保实论住时造调合没方也权。长与往叫理论所七将目再高。理支区油除定热产红就过市始别。与并长革看看共铁外不划清采面大。百业思算局起制院果小说感三老于过九度。",
    "image": "http://dummyimage.com/400x400",
    "number": "90",
    "attributes": [
        {
            "trait_type": "pariatur et id non",
            "value": "deserunt eu laboris"
        },
        {
            "trait_type": "dolor sit proident in",
            "value": "officia Duis"
        },
        {
            "trait_type": "Duis et laborum labore",
            "value": "eu occaecat Ut culpa"
        },
        {
            "trait_type": "tempor eiusmod aliquip",
            "value": "consequat officia Excepteur nulla sit"
        }
    ],
    "code": "47"
}'

返回响应

🟢200成功

application/json

Body

code

integer

请求状态

必需

0代表成功 -1代表错误

msg

string

提示信息

必需

请求提示信息

contract

string

合约地址

必需

合约地址

boxs

array [object {2}]

开启后的盲数组

必需

string

盲盒NFT ID

必需

uri

string

盲盒元数据URI

必需

该uri是一个json资源，也就是NFT的元数据，其中包含了name/description等NFT信息。需要自己去请求后做解析。

示例

成功示例异常示例

{
  "code": 0,
  "msg": "success",
  "contract": "cfxtest:achx5ekf1bsjj5xphbf5crgn9w00gy8dzpj5mtwbks",
  "boxs": [
    {
      "id": "5",
      "uri": "https://gugubox.oss-cn-hangzhou.aliyuncs.com/gugubox/17585383734/cfxtest:achx5ekf1bsjj5xphbf5crgn9w00gy8dzpj5mtwbks/metadata/5"
    },
    {
      "id": "6",
      "uri": "https://gugubox.oss-cn-hangzhou.aliyuncs.com/gugubox/17585383734/cfxtest:achx5ekf1bsjj5xphbf5crgn9w00gy8dzpj5mtwbks/metadata/6"
    }
  ]
}

修改于 2023-03-21 08:03:40

7.ERC721合约创建NFT盲盒

9.ERC721、ERC1155合约NFT的销毁