# ダイナミックNFT更新

## update**dnft** <a href="#createnft" id="createnft"></a>

既存のダイナミックNFTを更新します。

## **基本情報** <a href="#basic-info" id="basic-info"></a>

<table><thead><tr><th width="134">プロパティ</th><th width="226">詳細</th></tr></thead><tbody><tr><td>URL</td><td><code>/api/v1/updatednft</code></td></tr><tr><td>Method</td><td>POST</td></tr></tbody></table>

## **リクエストパラメータ** <a href="#request" id="request"></a>

<table><thead><tr><th width="231">パラメータ</th><th width="85">種類</th><th width="78">必須</th><th width="318">詳細</th></tr></thead><tbody><tr><td>nft_gdn_id</td><td>str</td><td>yes</td><td>対象NFTの<code>nft_gdn_id</code></td></tr><tr><td>contract_address</td><td>str</td><td>yes</td><td>コレクション(コントラクト)のアドレス</td></tr><tr><td>metadata</td><td>list</td><td>yes</td><td>NFTのメタデータ(下記参照)</td></tr></tbody></table>

## **metadata** <a href="#metadata" id="metadata"></a>

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

<table><thead><tr><th width="149">パラメータ</th><th width="76">種類</th><th width="73">必須</th><th width="393">詳細</th></tr></thead><tbody><tr><td>title</td><td>str</td><td>Yes</td><td>NFTのタイトル</td></tr><tr><td>description</td><td>str</td><td>Yes</td><td>NFTの説明</td></tr><tr><td>file_fields</td><td>list</td><td>Yes</td><td>ファイルアップロードが必要なメタデータの項目。KeyとUrlのペアで登録（下記参考）</td></tr><tr><td>attribute</td><td>list</td><td>No</td><td>NFTに追加するプロパティ。最大10個。</td></tr></tbody></table>

{% hint style="warning" %}
メタデータに設定できる項目の数は、`title`, `description`, 各`file_fields`を合計して10個。attributeは10個まで。
{% endhint %}

{% hint style="warning" %}
メタデータは指定した内容で上書きされます。(作成時のメタデータを上書きします)
{% endhint %}

## **file\_fields** <a href="#file-fields" id="file-fields"></a>

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

<table><thead><tr><th width="139">パラメータ</th><th width="76">種類</th><th width="75">必須</th><th width="397.12109375">詳細</th></tr></thead><tbody><tr><td>key</td><td>str</td><td>Yes</td><td>メタデータのkey。<code>image</code> または <code>animation_url</code> のどちらかを指定。 <code>image</code> は1つ以上必須。</td></tr><tr><td>url</td><td>str</td><td>Yes</td><td>画像または動画のURL</td></tr></tbody></table>

## attribute <a href="#attribute" id="attribute"></a>

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

<table><thead><tr><th width="139">パラメータ</th><th width="76">種類</th><th width="75">必須</th><th width="280">詳細</th></tr></thead><tbody><tr><td>tag</td><td>str</td><td>Yes</td><td>プロパティのタグ</td></tr><tr><td>value</td><td>str</td><td>Yes</td><td>プロパティの値</td></tr></tbody></table>

{% hint style="info" %}
URLに指定したファイルがIPFSなどのストレージにアップロードされます。
{% endhint %}

## **リクエストのサンプル** <a href="#sample" id="sample"></a>

```json
{
  "nft_gdn_id": "cf7faf94-a5ec-462c-ad06-1bd772fefe21",
  "contract_address": "0x0000000000000000000000000000000000000000",
  "metadata": [
    {
      "title": "NFT Name1 new",
      "description": "Description of NFT1 new",
      "file_fields": [
        {
          "key": "image",
          "url": "https://my.nftgarden.app/image_new.png"
        }
      ],
      "attribute": [
        {
          "tag": "color",
          "value": "Blue"
        },
        {
          "tag": "price",
          "value": "20000"
        }
      ]
    }
  ]
}
```

## **成功した場合のレスポンス例** <a href="#response" id="response"></a>

```json
{
  "message": "Create NFT request accepted",
  "requests": {
    "contract_address": "0x0000000000000000000000000000000000000000",
    "nft_gdn_id": "cf7faf94-a5ec-462c-ad06-1bd772fefe21",
    "metadata": [
      {
        "title": "NFT Name1 new",
        "description": "Description of NFT1 new",
        "file_fields": [
          {
            "key": "image",
            "url": "https://my.nftgarden.app/image_new.png"
          }
        ],
      "attribute": [
          {
            "tag": "color",
            "value": "Blue"
          },
          {
            "tag": "price",
            "value": "20000"
          }
        ]
      }
    ]
  },
  "nfts": [
    {
      "nft_gdn_ids": "cf7faf94-a5ec-462c-ad06-1bd772fefe21",
      "accepted_date": "2025-05-04 07:49:31"
    }
  ]
}
```

## **失敗した場合のレスポンス例(ステータスコード400)** <a href="#error" id="error"></a>

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