API

Resim yükle

Ürün ön gösterimi yükle

Hazır ürününün ön gösterim resmini yükle. Bu, ürünün üzerindeki motiflerin konumlandırması içindir.

Motifler yükle

Tüm baskı dosyalarını PNG / JPG biçiminde yükle.

Belgelendirme - Resim yükle

---

Geliştirici için

Resim dosyalarını doğrudan ikili dosya olarak yükle. Cevap olarak doğrudan gerekli ID’lere ve diğer bilgilere sahip medya nesnesini alırsın.

Talep örneği

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

raw content
                            

Cevap örneği

{
    "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"
}
                            

Ürün tasarla

Ürün seç

Ürününü tasarlamak için öncelikle bir ürün varyasyonuna ihtiyacın vardır. Bunu ürün havuzundan seçebilirsin.

Belgelendirme - Ürün seç

Ürün tasarla

Şimdi ürün görünümüne, ürün ön görünümünün medya-ID’lerini ve istenen motiflerin medya ID’lerini ekle.

Belgelendirme - Ürün tasarla

---

Geliştirici için

Tasarlanmış ürün varyasyonunun ID’si bir sonraki adımda sipariş için gerekli olacaktır.

Talep örneği

POST /variants/1/design
                            

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

    }
}
                            

Cevap örneği

{
    "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"
}
                            

Sipariş oluştur

Ürünler

Tasarlanmış ürün varyasyonlarının ID’lerini istenen miktarla birlikte ekle.

Belgelendirme - Ürünler

Gönderim adresi

Gönderim adresini ekle. Bu - eğer başka türlüsü belirtilmemişse - aynı zamanda fatura adresi olarak da kullanılacaktır.

Belgelendirme - Sipariş oluştur

---

Geliştirici için

Gönderim adresinin alanları eksiksiz olarak doldurulmuş olmalıdır. Bunlar aynı zamanda gönderi masraflarının tespiti için de gerekli olacaktır.

Talep örneği

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"
    }
}
                            

Cevap örneği

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

Gönderim maliyetlerini tespit et

Gönderim maliyetleri, kaydedilmiş hizmet sağlayıcılar tarafından boyut, ağırlık ve teslimat adresi doğrultusunda tespit edilir.

Belgelendirme - Gönderim maliyetlerini tespit et

---

Geliştirici için

Gönderim yönteminin “ele alımı” siparişin bir sonraki adımında gerekli olacaktır.

Talep örneği

GET /checkouts/1/shipping-rates
                            

Cevap örneği

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

Gönderim yöntemi belirle

Daha önce saptanmış gönderim olanakları arasından istenen gönderim yöntemini belirle.

Belgelendirme - Gönderim yöntemi belirle

---

Geliştirici için

“shipping.handle” özelliğini son adımdaki “handle” ile güncelle.

Talep örneği

PUT /checkouts/1
                            

{
    "shipping": {
        "handle": "pickup"
    }
}
                            

Cevap örneği

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

Siparişi tamamla

Ödeme yöntemi

Şu anda ödeme yöntemi olarak sadece fatura mevcuttur.

Belgelendirme - Siparişi tamamla

---

Geliştirici için

“Payment.handle”özelliğini “invoice” ile güncelle. Toplam tutar ürün fiyatları ve gönderim fiyatlarından belirlenir.

Talep örneği

POST /checkouts/1/complete
                            

{
    "payment": {
      "handle": "invoice",
      "amount": 150.0
    }
}
                            

Cevap örneği

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