サービス連携・API

クリエイターAPIリファレンス

API

API情報参照

API情報を取得します。

GET https://api.make.dmm.com/api/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID

返却値

変数 説明
resultCode number 4 API結果コード
resultMessage String 256 API結果メッセージ
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

このページのトップへ

素材

素材一覧参照

素材情報の一覧を取得します。

GET https://api.make.dmm.com/materials/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
materials Arrays --- 素材一覧
[ --- --- ---
materialId Numbers 10 素材ID
materialName Strings 100 素材名
materialIconUrl Strings 1024 素材アイコンURL
minVolume Numbers 20 最小体積(mm3)
整数部:17桁
小数点以下:3桁
maxVolume Numbers 20 最大体積(mm3)
整数部:17桁
小数点以下:3桁
maxX Numbers 10 高さ(mm)
整数部:7桁
小数点以下:3桁
maxY Numbers 10 幅(mm)
整数部:7桁
小数点以下:3桁
maxZ Numbers 10 奥行き(mm)
整数部:7桁
小数点以下:3桁
] --- --- ---
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

このページのトップへ

モデル

マイモデル一覧参照

アプリケーションに紐づくモデル一覧を取得します。

GET https://api.make.dmm.com/models/my/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
offset Numbers 10 --- 開始位置
デフォルト:0
limit Numbers 10 --- 取得件数
デフォルト:10
範囲:1~100
order Strings 32 --- 並び替え
新着(デフォルト): new
おススメ: recommend

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
models Arrays --- モデル一覧
[ --- --- ---
modelId Numbers 10 モデルID
modelName Strings 100 モデル名
modelStatusId Strings 10 モデルステータス
チェック待ち: 1
チェックOK: 2
要修正: 3
チェックNG: 4
修正中: 5
修正完了: 6
チェック中: 7
modelThumbnailUrl Numbers 1024 モデルサムネイル画像URL
modelPriceRow Numbers 14 最安価格(税抜き)
整数部: 12桁
小数点以下: 2桁
modelPriceHigh Numbers 14 最高価格(税抜き)
整数部: 12桁
小数点以下: 2桁
creatorName Strings 64 クリエイター名
skuCount Numbers 10 造形可能商品SKU数
recommendedFlg Strings 10 オススメ
OFF: 0
ON: 1
orderUrl Strings 1024 商品注文ページURL
] --- --- ---
totalCount Numbers 10 リスト全件数
offset Numbers 10 開始位置
count Numbers 10 件数
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル一覧参照

公開中のモデル一覧を取得します。

GET https://api.make.dmm.com/models/list/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
offset Numbers 10 --- 開始位置
デフォルト:0
limit Numbers 10 --- 取得件数
デフォルト:10
範囲:1~100
order Strings 32 --- 並び替え
新着(デフォルト): new
オススメ: recommend

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
models Arrays --- モデル一覧
[ --- --- ---
modelId Numbers 10 モデルID
modelName Strings 100 モデル名
modelStatusId Strings 10 モデルステータス
チェック待ち: 1
チェックOK: 2
要修正: 3
チェックNG: 4
修正中: 5
修正完了: 6
チェック中: 7
modelThumbnailUrl Numbers 1024 モデルサムネイル画像URL
modelPriceRow Numbers 14 最安価格(税抜き)
整数部: 12桁
小数点以下: 2桁
modelPriceHigh Numbers 14 最高価格(税抜き)
整数部: 12桁
小数点以下: 2桁
creatorName Strings 64 クリエイター名
skuCount Numbers 10 造形可能商品SKU数
recommendedFlg Strings 10 オススメ
OFF: 0
ON: 1
orderUrl Strings 1024 商品注文ページURL
] --- --- ---
totalCount Numbers 10 リスト全件数
offset Numbers 10 開始位置
count Numbers 10 件数
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル登録

モデルデータをアプリケーションに紐づけてアップロードします。

POST https://api.make.dmm.com/models/upload/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
model Files 100M モデルデータ
対応形式はこちら

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
modelId Numbers 10 モデルID
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル見積

モデルデータをアプリケーションに紐づけてアップロードします。その後、モデル解析結果通知(見積)APIから見積結果を返却します。(このAPIを実行してもモデルは登録されません)

POST https://api.make.dmm.com/models/quotation/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
model Files 100M モデルデータ
対応形式はこちら

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
modelId Numbers 10 モデルID
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル解析結果通知(登録)

モデルステータスが変更される度に、ユーザーが設定したURLにステータスのパラメータを付与して通知します。

POST アプリ登録時にユーザーが設定したURL

パラメータ

変数 必須 説明
modelId Numbers 10 モデルID
modelStatusId Strings 10 モデルステータス
チェック待ち: 1
チェックOK: 2
要修正: 3
チェックNG: 4
修正中: 5
修正完了: 6
チェック中: 7

モデル解析結果通知(見積)

見積APIでアップしたモデルの見積結果をユーザーが設定したURLにステータスのパラメータを付与して通知します。

POST アプリ登録時にユーザーが設定したURL

パラメータ

変数 必須 説明
modelId Numbers 10 モデルID
modelStatusId Strings 10 モデルステータス
チェック待ち: 1
チェックOK: 2
要修正: 3
チェックNG: 4
修正中: 5
修正完了: 6
チェック中: 7
modelItemInfo Strings 可変 JSONを返却します。返却内容は※を参照ください

※JSON(modelItemInfo) パラメータ

変数 必須 説明
modelName Strings 100 モデル名
modelPriceLow Numbers 14 最安価格(税抜き)
整数部12桁小数点以下2桁
modelPriceHigh Numbers 14 最高価格(税抜き)
整数部12桁小数点以下2桁
skuCount Numbers 10 造形可能商品SKU数
modelItemSkus Arrays 商品SKU情報
[
materialId Numbers 10 素材ID
itemSkuName Strings 100 商品SKU名
modelItemPriceTaxout Numbers 14 造形価格(税抜き)
整数部12桁小数点以下2桁
modelItemSkuX Numbers 10 モデルの高さ
整数部7桁小数点以下3桁
modelItemSkuY Numbers 10 モデルの幅
整数部7桁小数点以下3桁
modelItemSkuZ Numbers 10 モデルの奥行き
整数部7桁小数点以下3桁
modelItemSkuVolume Numbers 20 モデルの体積
整数部17桁小数点以下3桁
modelItemShells Numbers 10 シェル数(3Dデータ内のパーツ数)
整数10桁
]

モデル情報参照

アプリケーションに紐づく特定のモデルについての基本情報を取得します。

GET https://api.make.dmm.com/models/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
modelId Numbers 10 モデルID

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
modelId Numbers 10 モデルID
modelName Strings 100 モデル名
modelStatusId Strings 10 モデルステータス
チェック待ち: 1
チェックOK: 2
要修正: 3
チェックNG: 4
修正中: 5
修正完了: 6
チェック中: 7
modelPriceLow Numbers 14 最安価格(税抜き)
整数部: 12桁
小数点以下: 2桁
modelPriceHigh Numbers 14 最高価格(税抜き)
整数部: 12桁
小数点以下: 2桁
creatorName Numbers 64 クリエイター名
skuCount Numbers 10 造形可能商品SKU数
recommendedFlg Strings 10 オススメ
OFF: 0
ON: 1
modelPublicationFlg Strings 10 公開
OFF: 0
ON: 1
modelImages Arrays --- モデル画像
[ --- --- ---
imageId Strings 10 モデル画像ID
imageType Strings 10 画像種別
メイン: 1
サブ: 2
動画: 3
image Strings 1024 モデル画像
imageL Strings 1024 モデル画像サイズL
imageM Strings 1024 モデル画像サイズM
imageS Strings 1024 モデル画像サイズS
] --- --- ---
modelItemSkus Arrays --- 商品SKU情報
[ --- --- ---
modelItemSkuId Numbers 10 モデル商品SKUID
materialId Numbers 10 素材ID
itemSkuName Numbers 100 商品SKU名
itemSkuIconUrl Numbers 1024 商品SKUアイコン
modelItemPriceTaxout Numbers 14 造形価格(税抜き)
整数部:12桁
小数点以下:2桁
modelItemMarkupPriceTaxout Numbers 14 上乗せ価格(税抜き)
整数部:12桁
小数点以下:2桁
modelItemSkuX Numbers 10 モデルの高さ
整数部:7桁
小数点以下:3桁
modelItemSkuY Numbers 10 モデルの幅
整数部:7桁
小数点以下:3桁
modelItemSkuZ Numbers 10 モデルの奥行き
整数部:7桁
小数点以下:3桁
modelItemShells Numbers 10 シェル数(3Dデータ内のパーツ数)
整数10桁
modelItemSkuVolume Numbers 20 モデルの体積
整数部:17桁
小数点以下:3桁
modelItemSkuPublicationFlg Strings 10 商品SKU公開設定
OFF:0
ON:1
] --- --- ---
orderUrl Strings 1024 商品注文ページURL
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル情報更新

アプリケーションに紐づく特定のモデルについての基本情報を更新します。

POST https://api.make.dmm.com/models/update/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
modelId Numbers 10 モデルID
modelName Strings 100 --- モデル名
modelPublicationFlg Strings 10 --- 公開
OFF: 0
ON: 1
restrictPassword Strings 32 --- 限定公開パスワード。設定することで、非公開状態の商品でもパスワードをかけた公開を可能とする。
deletePasswordFlg Strings 10 --- 限定公開パスワード削除フラグ。限定公開パスワードを削除し、限定公開状態を非公開にする。
削除しない: 0
削除する: 1

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデルSKU情報更新

アプリケーションに紐づく特定のモデルについてのSKU情報を更新します。

POST https://api.make.dmm.com/models/update/sku/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
modelId Numbers 10 モデルID
modeItemSkuId Numbers 10 商品SKUID
modelItemSkuMarkupPriceTaxout Numbers 14 --- 上乗せ価格(税抜き)
範囲: 0~100万(マイナスはパラメータ不正)。
modelItemSkuPublicationFlg Strings 10 --- 商品SKU公開設定
OFF: 0
ON: 1

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル画像登録

アプリケーションに紐づく特定のモデルについての画像を登録します。

POST https://api.make.dmm.com/models/upload/images/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
modelId Numbers 10 モデルID
image File 1024 モデル画像

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル画像更新

アプリケーションに紐づく特定のモデルについての画像を更新します。

POST https://api.make.dmm.com/models/update/images/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
modelId Numbers 10 モデルID
imageId Numbers 10 画像ID
image File 1024 モデル画像

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデル画像削除

アプリケーションに紐づく特定のモデルの画像を削除します。

POST https://api.make.dmm.com/models/delete/images/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
modelId Numbers 10 モデルID
imageId Numbers 10 画像ID

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

モデルファイル詳細参照

アプリケーションに紐づく特定のモデルを取得します。

GET https://api.make.dmm.com/models/download/v1

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
modelId Numbers 10 モデルID

返却値

変数 説明
model File 100M モデル(処理が正常に行われる場合、ファイルダウンロード処理が行われ、API結果コードは返却されない)
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

このページのトップへ

価格

価格計算NEW

体積・高さ・幅・奥行を元に価格を計算します。

GET https://api.make.dmm.com/prices/v2

価格改定が実施されました。価格計算にはこちらのAPIをご使用ください。

パラメータ

変数 必須 説明
applicationId Strings 32 アプリケーションごとに発行されるID
volume Numbers 20 体積(mm3)
整数部:17桁
小数点以下:3桁
X Numbers 10 高さ(mm)
整数部:7桁
小数点以下:3桁
Y Numbers 10 幅(mm)
整数部:7桁
小数点以下:3桁
Z Numbers 10 奥行(mm)
整数部:7桁
小数点以下:3桁
shells Numbers 3 シェル数(3Dデータ内のパーツ数)を指定
最小値:1
最大値:100

返却値

変数 説明
resultCode String 4 API結果コード
resultMessage String 256 API結果メッセージ
prices Arrays --- 素材価格一覧
[ --- --- ---
materialId Numbers 10 素材ID
materialName Strings 100 素材名
materialPrice Numbers 14 造形価格(税抜き)
] --- --- ---
resultErrors Strings 4096 エラー詳細、result_codeが「200」以外の場合設定される。

このページのトップへ

API結果コード


コード一覧

結果コード 説明
200 正常終了
100 パラメータエラー
501 アプリケーションエラー
900 メンテナンス中
999 システムエラー(予期せぬエラー)

このページのトップへ