NFT付与(生成+転送)

createnfttrans

新規にNFTを生成し、同時に転送します。

基本情報

プロパティ	詳細
URL	/api/v1/createnfttrans
Method	POST

リクエストパラメータ

パラメータ	種類	必須	詳細
contract_address	str	yes	コレクション(コントラクト)のアドレス
blockchain	str	yes	生成先のブロックチェーン
receiver_wallet_address	str	Yes	NFT転送先の所有者
metadata	object	yes	NFTのメタデータ

blockchainパラメータに指定できるブロックチェーン

対応ブロックチェーンのページのネットワークの項目の名称をご指定ください。

solanaとsolana-testnetは未対応です。

blockchainパラメータで指定するブロックチェーンとコレクション(contract_address)のブロックチェーンが一致する必要があります。

metadata

NFTのメタデータを定義します。ファイルアップロードが必要な項目は、file_fieldsに指定します。

パラメータ	種類	必須	詳細
title	str	Yes	NFTのタイトル
description	str	Yes	NFTの説明
file_fields	list	Yes	ファイルアップロードが必要なメタデータの項目。KeyとUrlのペアで登録（下記参考）。最大8件。
attribute	list	No	NFTに追加するプロパティ
任意	str	No	その他メタデータ

メタデータの数は、title, description, 各file_fields, 任意のものを合計して10個。

file_fields

file_fieldsはkey, urlのペアの配列です。

パラメータ	種類	必須	詳細
key	str	Yes	メタデータのkey
url	str	Yes	アップロードするファイルのURL

attribute

attributeはtag,valueのペアの配列です。

パラメータ	種類	必須	詳細
tag	str	Yes	プロパティのタグ
value	str	Yes	プロパティの値

URLに指定したファイルがIPFSなどのストレージにアップロードされます。

リクエストのサンプル

{
  "contract_address": "0x0000000000000000000000000000000000000000",
  "blockchain": "polygon",
  "receiver_wallet_address": "0x2222222222222222222222222222222222222222",
  "metadata": [
    {
      "title": "NFT Name1",
      "description": "Description of NFT1",
      "file_fields": [
        {
          "key": "image",
          "url": "https://my.nftgarden.app/image.png"
        }
    ],
      "attribute": [
        {
          "tag": "color",
          "value": "Red"
        }
      ]
    },
    {
      "title": "NFT Name2",
      "description": "Description of NFT2",
      "file_fields": [
        {
          "key": "image",
          "url": "https://my.nftgarden.app/image.png"
        }
      ]
    }
  ]
}

成功した場合のレスポンス例

{
  "message": "Create NFT request accepted",
  "requests": {
    "contract_address": "0x0000000000000000000000000000000000000000",
    "receiver_wallet_address": "0x2222222222222222222222222222222222222222",
    "metadata": [
      {
        "title": "NFT Name1",
        "description": "Description of NFT1",
        "file_fields": [
          {
            "key": "image",
            "url": "https://my.nftgarden.app/image.png"
          }
        ],
      "attribute": [
          {
            "tag": "color",
            "value": "Red"
          }
        ]
      },
      {
        "title": "NFT Name2",
        "description": "Description of NFT2",
        "file_fields": [
          {
            "key": "image",
            "url": "https://my.nftgarden.app/image.png"
          }
        ],
        "attribute": [
          {
            "tag": "color",
            "value": "Blue"
          }
        ]
      }
    ]
  },
  "nfts": [
    {
      "nft_gdn_ids": "cf7faf94-a5ec-462c-ad06-1bd772fefe21",
      "accepted_date": "2022-07-04 04:20:18"
    },
    {
      "nft_gdn_ids": "b27752b7-9803-4d28-b29f-9532ad0f0dbb",
      "accepted_date": "2022-07-04 04:20:18"
    }
  ]
}

失敗した場合のレスポンス例(ステータスコード400)

{
  "error": {
    "title": "Bad Request",
    "message": "contract_address and blockchain are inconsistent"
  }
}