アセットAPIは、メディアファイルのようなアセットに関する情報を登録および取得することを提供します。
アセットをアップロード
アップロードされたアセット(jpg、png、gifなどのメディアファイル)をパブリックIPFS(InterPlanetary File System)にアップロードします。アップロードされたアセットのIPFSのアドレス(uri
)と、HTTP経由でアクセス可能なゲートウェイアドレス(gatewayUrl
)を提供します。
リクエストURL
ヘッダーパラメータ
リクエストボディ
応答
リクエストサンプル
curl -X 'POST'
'https://sandbox-bc-api.qpyou.cn/core/v1/asset'
-H 'accept: application/json'
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlObyI6MSwiaWQiOiJwbGF0Zm9ybSIsImNvbXBhbnkiO'
-H 'Content-Type: multipart/form-data'
-F 'asset=@cw20.code'
応答サンプル
{
"code": 0,
"message": "success",
"data": {
"contentType": "application/octet-stream",
"uri": "ipfs://QmPStJZ7o4kSQH2R64sRWq8YpJ9VgDb1QoHjAmyhCmekTi",
"gatewayUrl": "https://sandbox-bc-file.qpyou.cn/ipfs/QmPStJZ7o4kSQH2R64sRWq8YpJ9VgDb1QoHjAmyhCmekTi"
}
}
公開URLでアセットをアップロード
アップロードされたアセット(jpg、png、gifなどのメディアファイル)をパブリックIPFSにアップロードします。ファイルを直接アップロードするのではなく、パブリックURLを介してアップロードします。アップロードされたアセットのIPFSのアドレス(uri
)と、HTTPを介してアクセスできるゲートウェイアドレス(gatewayUrl
)を提供します。
リクエストURL
ヘッダーパラメータ
リクエストボディ
応答
リクエストサンプル
curl -X 'POST'
'https://sandbox-bc-api.qpyou.cn/core/v1/asset-by-url'
-H 'accept: application/json'
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlObyI6MSwiaWQiOiJwbGF0Zm9ybSIsImNvbXBhbnkiO'
-H 'Content-Type: application/json'
-d '{
"url": "https://image01.c2x.world/equip_92053030.gif"
}'
応答サンプル
{
"code": 0,
"message": "success",
"data": {
"contentType": "image/gif",
"uri": "ipfs://QmV7GWnGgQU3szBBDQz1MmigtUjddmuAt7SjrWZeXP6cVF",
"gatewayUrl": "https://sandbox-bc-file.qpyou.cn/ipfs/QmV7GWnGgQU3szBBDQz1MmigtUjddmuAt7SjrWZeXP6cVF"
}
}
アセット情報を取得する
コンテンツ識別子(cid
)を介して、公開用のアセットURLを取得します。
リクエストURL
ヘッダーパラメータ
パスパラメータ
応答
リクエストサンプル
curl -X 'GET'
'https://sandbox-bc-api.qpyou.cn/core/v1/asset/QmV7GWnGgQU3szBBDQz1MmigtUjddmuAt7SjrWZeXP6cVF'
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlObyI6MSwiaWQiOiJwbGF0Zm9ybSIsImNvbXBhbnkiO'
-H 'accept: application/json'
応答サンプル
{
"code": 0,
"message": "success",
"data": {
"assetUri": "https://sandbox-bc-file.qpyou.cn/ipfs/QmV7GWnGgQU3szBBDQz1MmigtUjddmuAt7SjrWZeXP6cVF"
}
}