アップロード

Smake

API

印刷(DTG)と完成

印刷し、API リクエストと製品を送信します。

  • 弊社の全製品カタログより、メーカー価格にてご注文ください。
  • 中間業者は入りません。
  • 数量に関わらず、競争力のある卸売価格を維持できます。
  • API 経由で完全に統合された、簡単で低コストなプロセス。
  • ラベル発送、注文/配送確認など、すべての機能を統合後すぐにご利用いただけます。

開発者の方へ—ご利用の準備

生産から注文、販売まで、万全のサポート体制をご用意しております。

画像をアップロード

製品プレビューをアップロード

最終製品のサムネイルをアップロードしてください。 ロゴとして製品に配置されます。

ロゴをアップロード

すべての印刷ファイルを PNG / JPG 形式でアップロードしてください。

ドキュメント - 画像をアップロード

開発者の方へ

画像をバイナリデータで直接アップロードできます。 必要な ID やその他情報とメディアオブジェクトが、すぐに送信されます。

リクエスト例

POST /media
Content-Type: image/jpeg
Content-Length: 42840
                            

raw content
                            
レスポンス例

{
    "id": 1,
    "is_test": true,
    "file_name": "39b8196929f742e7bccab01a643b6524.jpeg",
    "size": 42840,
    "mime_type": "image/jpeg",
    "download_url": "https://api.smake.io/v2/media/1/download",
    "created_at": "2017-09-28T08:40:44+00:00",
    "updated_at": "2017-09-28T08:40:44+00:00"
}
                            

製品をデザイン

製品を選択

製品のデザインを始める前に、製品バリアントを作成してください。 製品集の中から、製品バリアントを選択できます。

ドキュメント - 製品を選択
製品を作成

製品表示、製品プレビューのメディア ID、ロゴのメディア ID を追加します。

ドキュメント - 製品を作成

開発者の方へ

デザインした製品のバリアント ID は、注文の次の段階で必要となります。

リクエスト例

POST /variants/1/design
                            

{
    "views": {
        "front": {
            "composite_media_id": 1,
            "customizations": [
                {
                    "type": "dtg",
                    "production_media_id": 2,
                    "dimension": {
                        "width": 100.55,
                        "height": 200.66
                    }
                },
                ...
            ]
        }

    }
}
                            
レスポンス例

{
    "id": 2,
    "is_test": true,
    "total": 259.98,
    "price": 218.47,
    "tax": 41.51,
    "tax_rate": 19,
    "code": null,
    "attributes": [
        {
            "name": "color",
            "value": "LightYellow"
        },
        {
            "name": "size",
            "value": "XL"
        }
    ],
    "media_id": 1094,
    "views": {
        ...
        "front": {
            "composite_media_id": 1,
            "customizations": [
                {
                    "type": "dtg",
                    "production_media_id": 2,
                    "preview_media_id": 3,
                    "dimension": {
                        "width": 100.55,
                        "height": 200.66
                    }
                },
            ]
        },
        ...
    },
    "created_at": "2017-09-28T14:48:05+00:00",
    "updated_at": "2017-09-28T14:48:05+00:00"
}
                            

注文を作成

製品

デザインした製品のバリアント ID と数量を入力してください。

ドキュメント - 製品
配送先住所

配送先住所を追加してください。 特別な記載のない限り、配送先住所が請求先住所となります。

ドキュメント - 注文を作成

開発者の方へ

配送先住所の属性をすべて入力してください。 配送先住所の属性は、配送料の計算に使用されます。

リクエスト例

POST /checkouts
                            

{
    "email": "customer@example.com",
    "items": [
        {
            "variant_id": 1,
            "quantity": 1
        }
    ],
    "shipping_address": {
        "first_name": "John",
        "last_name": "Doe",
        "street1": "123 Main St",
        "zip": "12345",
        "city": "Anytown",
        "country_code": "DE",
        "province_code": "NW",
        "phone": "12345 67890",
        "email": "shipping@example.com"
    }
}
                            
レスポンス例

{
    "id": 1,
    "is_test": true,
    "external_identifier": null,
    "project_name": null,
    "state": "incompleted",
    "customer_locale": "en",
    "currency": "EUR",
    "total": 123.75,
    "subtotal": 103.99,
    "total_tax": 19.76,
    "total_items_price": 123.75,
    "shipping_line": [],
    "created_at": "2017-09-29T09:14:11+00:00",
    "updated_at": "2017-09-29T09:14:11+00:00",
    "cancelled_at": null,
    "items": [
        {
            "id": 75,
            "quantity": 1,
            "total": 123.75,
            "price": 103.99,
            "total_tax": 19.76,
            "tax_rate": 19,
            "variant": {
                "id": 2,
                ...
            },
            "created_at": "2017-09-29T09:14:11+00:00",
            "updated_at": "2017-09-29T09:14:11+00:00",
            "cancelled_at": null
        }
    ],
    "customer": {
        "id": 98,
        ...
    },
    "shipping_address": {
        "id": 190,
        ...
    },
    "billing_address": {
        "id": 191,
        ...
    },
    "whitelabel_address": null,
    "transactions": [],
    "fulfillments": [],
    "id_tags": []
}
                            

配送料を計算

配送料はファイル上の配送業者の料金に応じ、寸法、重量、配送先の住所に基づいて計算されます。

ドキュメント - 配送料を計算

開発者の方へ

配送方法の「handle」は、注文の次の段階で必要となります。

リクエスト例

GET /checkouts/1/shipping-rates
                            
レスポンス例

{
    "data": [
        {
            "is_test": true,
            "handle": "pickup",
            "title": "Abholung",
            "price": 22
        }
    ],
    ...
}
                            

配送方法を指定

すでに指定した配送オプションの中からご希望の配送方法を選択できます。

ドキュメント - 配送方法を指定

開発者の方へ

前段階からの「handle」で「shipping.handle」属性を更新してください。

リクエスト例

PUT /checkouts/1
                            

{
    "shipping": {
        "handle": "pickup"
    }
}
                            
レスポンス例

{
    ...
    "shipping_line": {
        "title": "Pickup",
        "price": 22.06,
        "total": 26.25,
        "tax": 4.19
    },
    ...
}
                            

注文を完了

支払方法

現在ご利用いただけるお支払い方法は、請求書によるお支払いのみです。

ドキュメント - 注文を完了

開発者の方へ

「invoice」で「payment.handle」属性を更新してください。合計金額は、製品価格と配送料に基づいて計算されます。

リクエスト例

POST /checkouts/1/complete
                            

{
    "payment": {
      "handle": "invoice",
      "amount": 150.0
    }
}
                            
レスポンス例

{
    "id": 1,
    "is_test": true,
    "external_identifier": null,
    "project_name": "et",
    "state": "delivered",
    "customer_locale": "en",
    "currency": "EUR",
    "total": 87.76,
    "subtotal": 86.63,
    "total_tax": 1.13,
    "total_items_price": 82.98,
    "shipping_line": {
        "title": "Pickup",
        "price": 4.47,
        "total": 4.78,
        "tax": 0.31
    },
    "created_at": "2017-09-27T10:10:59+00:00",
    "updated_at": "2017-09-27T10:11:03+00:00",
    "cancelled_at": null,
    "items": [
        {
            "id": 1,
            "quantity": 4,
            "total": 82.98,
            "price": 20.54,
            "total_tax": 0.82,
            "tax_rate": 1,
            "variant": {
                "id": 27,
                ...
            },
            "created_at": "2017-09-27T10:10:59+00:00",
            "updated_at": "2017-09-27T10:10:59+00:00",
            "cancelled_at": null
        }
    ],
    "customer": {
        "id": 40,
        ...
    },
    "shipping_address": {
        "id": 45,
        ...
    },
    "billing_address": {
        "id": 44,
        ...
    },
    "whitelabel_address": null,
    "transactions": [
        ...
    ],
    "fulfillments": [
        ...
    ],
    "id_tags": [
        ...
    ]
}