NMKR Docs
ProductsContact
日本語
日本語
  • NMKR Docsへようこそ
  • 導入
    • NMKRについて
    • NMKRの事例
    • NFTとは?
      • IPFSとは何ですか?
    • なぜCardanoなのか?
  • NMKR Studio
    • はじめに - NMKR Studio
    • 機能の概要
    • 🖥️NMKR Studioを3分で学ぶ
      • 基本ワークフロー
    • 使用方法 - 簡単なチュートリアル
      • 簡単な動画チュートリアル
      • プロジェクトを計画するときのガイドライン
      • トークンの追加方法
      • メタデータの設定方法
      • トークンの販売方法
      • 販売条件の設定方法
      • 公開の設定方法
      • トークンをバーンする方法
      • ロイヤルティを有効にする方法
      • DIDを有効にする方法
      • ホワイトリストの設定方法
      • トークンをエアドロップする方法
    • 価格設定
    • アカウント
      • 登録とKYC
      • セキュリティ
      • ウォレット
      • ミントクーポン
      • ダッシュボード
      • 取引
      • 請求書
      • APIのキー
    • プロジェクト
      • ポリシー
        • ポリシーを管理
      • 作成
      • 編集
      • メタデータテンプレート
      • 統計
      • DID - 分散型ID
      • 通知
      • ロイヤルティ
      • 追加ペイアウトウォレット
      • アフィリエイト・リンク
      • メタデータをZip形式でエクスポート
      • NFTをcsv形式でエクスポート
      • ミント&送信ジョブ
      • placeholder.csvをエクスポート
    • トークン
      • トークンタブを管理
      • アップロード
        • 単一トークンのアップロード
        • ファイルとメタデータの一括アップロード
          • ドラッグ&ドロップで一括アップロード
          • SFTP経由で一括アップロード
      • 編集
      • メタデータ
        • トークン固有のメタデータの追加
        • フィンガープリント(メタデータプレビュー)
        • メタデータチェック
        • 代替可能トークンのメタデータ標準
        • 完全なオンチェーンNFT
          • 部分的なURLエンコード
        • CIP-68
      • 複製
      • 削除
      • バーン
      • アップデート(ミント/公開後に編集)
    • 販売設定
      • 価格管理 / 価格リスト
        • 新しい価格の設定
        • 無料ドロップ
        • カスタム・トークンの支払い
        • 割引
      • 販売条件とホワイトリスト
        • ポリシーIDまたはステークプールによる販売条件
        • カウント付きホワイトリスト
        • ブラックリスト
        • 販売条件テスト
      • トークンをブロックする
      • NMKR Pay
        • NMKR Payの設定
        • マルチシグ決済
        • ウェブサイトの統合
        • 特定の支払いリンク
        • NMKR Payでのマニュアル送付
        • フィアット、ETHとSOLの支払い
      • Pay-In Address
      • オークション
    • ミント
      • オンデマンドミント
      • マニュアルミント
      • エアドロッパー
        • ランダム配布のエアドロップ
        • 特定の配布のエアドロップ
    • ツール
      • 管理ウォレット
      • 分割アドレス
      • 直接販売
      • ポリシー・スナップショット
      • 統合&プラグイン
        • NFT Pal
        • Zapier
    • テストネット
      • テストネットアカウントの作成
      • テストネットウォレットとtADA
      • Testnet API Swagger
  • NMKR Studio API
    • はじめに - NMKR Studio API
    • API機能
    • Swagger API Endpoints
    • APIを使い始める
    • API Swagger
      • Swaggerをはじめる
      • Swaggerの応答とエラーコード
    • APIの例
      • プロジェクト
        • プロジェクトの作成
        • ファイルとメタデータのアップロード
      • 支払い
        • トークンのランダム販売用にユニークなNMKRペイリンクを作成する
        • 特定のトークン販売用にNMKR Pay Linkを作成する
        • ネイティブ・トークンを使用した単一NFT販売の支払いアドレスの取得
        • 複数トークン販売用にNMKR Pay Linkを作成する
      • ミント
        • 手動ミント
      • スマートコントラクト
        • NMKR Payによる二次販売
    • APIオープンソースへの貢献
  • NMKRミント
    • はじめに - NMKRミント
    • ミント・シングルNFT
    • ミント・コレクション
  • NMKRプレイグラウンド
    • はじめに - NMKRプレイグラウンド
    • ADA支払いリンク
    • ペーパーウォレット
  • NMKRプール
    • ステーキングとは何か?
    • NMKRプールとステーク
  • 便利なリンク
    • Cardano NFT リソース
    • カルダノのリソース
    • Cardanoウォレット
    • オープンソースのリポジトリ
    • セキュリティ対策
    • ボットへの対応
GitBook提供
このページ内
  1. NMKR Studio API
  2. APIの例
  3. プロジェクト

ファイルとメタデータのアップロード

プロジェクトにファイルをアップロードする

前へプロジェクトの作成次へ支払い

最終更新 12 か月前

以下のエンドポイントを使用すると、トークンをアップロードし、オプションでプレースホルダ値を定義したり、メタデータをオーバーライドするための完全なメタデータコードを定義したりすることができます。

ペイロードにメタデータをアップロードする場合は、メタデータをエスケープする必要があることに注意してください。

エンドポイント

/v2/UploadNft

ボディ

トークンをアップロードするためのリクエストフィッティングのボディを定義します。アップロードに該当しないフィールドは削除してください。BASE64コンテンツ、URLリンク、またはIPFSハッシュとしてファイルをアップロードするオプションがあります。Metadataを送信した場合、プロジェクトのMetadatatemplateの代わりに使用されます。MetadataまたはMetadataPlaceholderのどちらかを送信できますが、両方を送信することはできません。

{
  "tokenname": "string",
  "displayname": "string",
  "description": "string",
  "previewImageNft": {
    "mimetype": "string",
    "fileFromBase64": "string",
    "fileFromsUrl": "string",
    "fileFromIPFS": "string"
  },
  "subfiles": [
    {
      "subfile": {
        "mimetype": "string",
        "fileFromBase64": "string",
        "fileFromsUrl": "string",
        "fileFromIPFS": "string"
      },
      "description": "string",
      "metadataPlaceholder": [
        {
          "name": "string",
          "value": "string"
        }
      ]
    }
  ],
  "metadataPlaceholder": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "metadataOverride": "string",
  "priceInLovelace": 0
}

この例では、ボディをこのように指定しました:

{
  "tokenname": "thetoken1",
  "displayname": "The Token 1",
  "description": "This is a test",
  "previewImageNft": {
    "mimetype": "image/png",
    "fileFromIPFS": "QmfA66piVcujJoSmL1fu1beJS2agvadXbzwv4hX4dnzqWY"
  },
  "subfiles": [
    {
      "subfile": {
        "mimetype": "image/png",
        "fileFromIPFS": "QmPep292dYH9CXH9AcMgbcEohXUc3P8ERbAfw7r9HM3AdY"
      }
    }
  ],
  "metadataPlaceholder": [
    {
      "name": "background",
      "value": "green"
    }
  ]
}

Curl

curl -X 'POST' \
  'https://studio-api.nmkr.io/v2/UploadNft/1420d55a-e194-4aa6-b57d-6d0f0d3b0738' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer 1ac2cb0abea146f7bb8a90701dad311c' \
  -H 'Content-Type: application/json' \
  -d '{
  "tokenname": "thetoken1",
  "displayname": "The Token 1",
  "description": "This is a test",
  "previewImageNft": {
    "mimetype": "image/png",
    "fileFromIPFS": "QmfA66piVcujJoSmL1fu1beJS2agvadXbzwv4hX4dnzqWY"
  },
  "subfiles": [
    {
      "subfile": {
        "mimetype": "image/png",
        "fileFromIPFS": "QmPep292dYH9CXH9AcMgbcEohXUc3P8ERbAfw7r9HM3AdY"
      }
    }
  ],
  "metadataPlaceholder": [
    {
      "name": "background",
      "value": "green"
    }
  ]
}'

応答

{
  "nftId": 13174329,
  "nftUid": "8deedfd7-6aa4-45df-be6b-27efa51b8ec3",
  "ipfsHashMainnft": "QmfA66piVcujJoSmL1fu1beJS2agvadXbzwv4hX4dnzqWY",
  "ipfsHashSubfiles": [
    "QmPep292dYH9CXH9AcMgbcEohXUc3P8ERbAfw7r9HM3AdY"
  ],
  "metadata": "{\n  \"721\": {\n    \"63cb7af8c980f0867940e765f36fa53ac948d9af51179742291a553e\": {\n      \"thetoken1\": {\n        \"name\": \"The Token 1\",\n        \"image\": \"ipfs://QmfA66piVcujJoSmL1fu1beJS2agvadXbzwv4hX4dnzqWY\",\n        \"mediaType\": \"image/png\",\n        \"description\": \"This is a test\",\n        \"files\": [\n          {\n            \"name\": \"The Token 1\",\n            \"mediaType\": \"image/png\",\n            \"src\": \"ipfs://QmPep292dYH9CXH9AcMgbcEohXUc3P8ERbAfw7r9HM3AdY\"\n          }\n        ]\n      }\n    },\n    \"version\": \"1.0\"\n  }\n}",
  "assetId": "63cb7af8c980f0867940e765f36fa53ac948d9af51179742291a553e746865746f6b656e31"
}

プレースホルダーの代わりにメタデータ・オーバーライドを使う

完全な721メタデータJSONを提出したい場合、リクエストボディのMetadataPlaceholderフィールドを削除し、Metadata overrideフィールドを使用しなければならないことに留意してください。

  "metadataOverride": "string",

プレースホルダ・メソッドを使用する場合と同じように Curl を送信し続け、エスケープされたメタデータをフィールドに追加します:

  "metadataOverride": "{\r\n  \"721\": {\r\n    \"63cb7af8c980f0867940e765f36fa53ac948d9af51179742291a553e\": {\r\n      \"thetoken1\": {\r\n        \"name\": \"The Token 1\",\r\n        \"image\": \"ipfs:\/\/QmfA66piVcujJoSmL1fu1beJS2agvadXbzwv4hX4dnzqWY\",\r\n        \"mediaType\": \"image\/png\",\r\n        \"background\": \"green\",\r\n        \"description\": \"This is a test\",\r\n        \"files\": [\r\n          {\r\n            \"name\": \"The Token 1\",\r\n            \"mediaType\": \"image\/png\",\r\n            \"src\": \"ipfs:\/\/QmPep292dYH9CXH9AcMgbcEohXUc3P8ERbAfw7r9HM3AdY\"\r\n          }\r\n        ]\r\n      }\r\n    },\r\n    \"version\": \"1.0\"\r\n  }\r\n}",

MetadataOverrideでメタデータを与える代わりに、metadataPlaceholderメソッドを使ってカスタムフィールドを定義しました。このプレースホルダ・メソッドは、カスタム・フィールドが指定されている場合にのみ機能することに留意してください。

MetadataOverrideを使用したい場合は、ください。

オンラインJSONエスケープ/Unescapeツール https://www.freeformatter.com/json-escape.html#before-output
メタデータ・テンプレートで
こちらをお読み