초대

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
        }
    ],
    ...
}
                            

딜리버리 방법 설정

원하는 딜리버리 방법을 이전에 산출한 딜리버리 옵션을 바탕으로 설정하세요.

기록 - 딜리버리 방법 설정

개발자를 위한 정보

속성 "shipping.handle"을 마지막 단계에서 요청한 "handle"로 업데이트하세요.

예: 요청

PUT /checkouts/1
                            

{
    "shipping": {
        "handle": "pickup"
    }
}
                            
예: 답변

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

주문 완료

지불 방법

현재 지불 방법으로 인보이스 발송 옵션만 사용할 수 있습니다.

기록 - 주문 완료

개발자를 위한 정보

속성 "payment.handle"을 "invoice"로 업데이트하세요. 총액은 제품 가격과 딜리버리 비용이 합산되어 산출됩니다.

예: 요청

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": [
        ...
    ]
}