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を返却します。返却内容は※を参照ください |
変数 | 型 | 桁 | 必須 | 説明 |
---|---|---|---|---|
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情報を更新します。
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」以外の場合設定される。 |
体積・高さ・幅・奥行を元に価格を計算します。
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」以外の場合設定される。 |