如何通过nft-maker.io的API使用占位符POST提交JSON元数据

问题核心错误点 #

1. metadataPlaceholder结构不符合接口要求
   官方定义的metadataPlaceholder为对象数组，每个数组元素是包含固定name和value字段的独立对象，分别对应占位符名称和要替换的值。你之前把所有占位符键值对塞到同一个对象中，平台无法识别匹配，所以占位符全部替换为空。
2. 全量metadata字段传参存在疏漏
   如果选择直接传metadata字段覆盖预设值：

• 需手动将metadata字符串中的<policy_id>替换为你项目的实际政策ID，手动传入的元数据不会触发平台预设占位符的自动替换逻辑
• 需确保JSON字符串的转义完全合法，你之前返回结果中出现的"<policy_id>""多余双引号就是转义错误导致的元数据解析失败

正确请求示例 #

方案1：使用metadataPlaceholder赋值（推荐）

{
    "assetName": "Testing01",
    "previewImageNft": {
        "mimetype": "image/png",
        "fileFromIPFS": "QmUp9ZnFbHegzdwtg8ToXJK7kjrJrkZcKuCuXGAREeXNDr",
        "metadataPlaceholder": [
            {"name": "place_holder1", "value": "The info I need goes here"},
            {"name": "place_holder2", "value": "The info I need goes here"},
            {"name": "place_holder3", "value": "The info I need goes here"},
            {"name": "place_holder4", "value": "The info I need goes here"},
            {"name": "place_holder5", "value": "对应内容"},
            {"name": "place_holder6", "value": "对应内容"},
            {"name": "place_holder7", "value": "对应内容"},
            {"name": "place_holder8", "value": "对应内容"},
            {"name": "place_holder9", "value": "对应内容"}
        ]
    }
}

方案2：使用metadata字段全量覆盖

注意替换你的实际政策ID为项目对应值：

{
    "assetName": "Testing01",
    "previewImageNft": {
        "mimetype": "image/png",
        "fileFromIPFS": "QmUp9ZnFbHegzdwtg8ToXJK7kjrJrkZcKuCuXGAREeXNDr"
    },
    "metadata": "{\"721\":{\"你的实际政策ID\":{\"Testing01\":{\"one\":\"FIRST\",\"two\":\"SECOND\",\"three\":\"THIRD\",\"four\":\"FOURTH\",\"five\":\"FIFTH\",\"six\":\"SIXTH\",\"seven\":\"SEVENTH\",\"eight\":\"EIGHTH\",\"nine\":\"NINTH\",\"files\":[{\"name\":\"Testing01\",\"mediaType\":\"image/png\",\"src\":\"ipfs://QmUp9ZnFbHegzdwtg8ToXJK7kjrJrkZcKuCuXGAREeXNDr\"}]}}}"
}

内容的提问来源于stack exchange，提问作者André Andrade