يدعو

Smake

واجهة برمجة التطبيقات

لطباعة (DTG) والإتمام

طباعة وإرسال المنتجات باستخدام استدعاء واجهة برمجة التطبيقات بسيط

  • اطلب من كتالوج منتجاتنا بالكامل - الأسعار مباشرة من المنتج.
  • لا يوجد وسيط.
  • أسعار جملة قادرة على المنافسة تبدأ من قطعة واحدة.
  • عملية بسيطة وفعالة من حيث التكلفة عبر واجهة برمجة التطبيقات المتوفرة لدينا - متكاملة تمامًا.
  • بعد التكامل، يمكنك البدء فورًا والاستفادة من جميع الميزات مثل شحن البطاقة البيضاء والتحكم في الطلبيات والشحن.

أول خطوات للمطور

من إنشاء المنتجات إلى تعقب الطلبيات ووصلاً إلى الإنتاج - لدينا كل شيء تحت السيطرة.

تحميل الصور

تحميل معاينة المنتج

قم بتحميل الصورة المصغرة للمنتج النهائي الخاص بك. يستخدم هذا لوضع الحوافز على منتجك.

تحميل حوافز

قم بتحميل كل ملفات الطباعة على هيئة PNG / JPG.

المستندات - تحميل الصور

للمطور

قم بتحميل بيانات الصور مباشرةً كملف ثنائي. كاستجابة ستسترد مباشرةً كائن الوسائط مباشرةً مع المعرفات المطلوبة ومزيد من المعلومات.

مثال على الطلب

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

تصميم المنتج

اختيار المنتجات

لتصميم منتجك، تحتاج أولاً إلى متغير منتج. يمكنك العثور على هذا من خلال أداة المنتجات

المستندات - اختيار المنتجات
تشكيل المنتج

أضف الآن عرض المنتج المطلوب ومعرّف وسائط معاينة المنتج ومعرّفات الوسائط الخاصة بالحوافز المطلوبة.

المستندات - تشكيل المنتج

للمطور

سيكون معرّف متغير المنتج المُصمم مطلوبًا في الخطوة التالية للطلب.

مثال على الطلب

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

إنشاء الطلب

المنتجات

قم بإضافة معرّفات متغيرات المنتج المصممة بالكمية المطلوبة.

المستندات - المنتجات
عنوان الشحن

أضف عنوان الشحن. هذا - ما لم ينص على خلاف ذلك - يُستخدم أيضًا كعنوان للفوترة.

المستندات - إنشاء الطلب

للمطور

يجب إكمال سمات عنوان الشحن. هذه مطلوبة، من بين أمور أخرى، لتحديد تكاليف الشحن.

مثال على الطلب

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

تحديد مصاريف الشحن

يتم تحديد تكاليف الشحن على أساس المقاس والوزن وعنوان التسليم لدى مزودي خدمة الشحن المودعين.

المستندات - تحديد مصاريف الشحن

للمطور

تلزم "معالجة" طريقة التسليم في الخطوة التالية من الطلب.

مثال على الطلب

GET /checkouts/1/shipping-rates
                            
مثال على الاستجابة

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

ضبط طرق التسليم

قم بضبط طريقة التسليم المطلوبة استنادًا إلى خيارات التسليم المحددة مسبقًا.

المستندات - ضبط طرق التسليم

للمطور

قم بتحديث السمة "معالجة الشحن" بـ "المعالجة" المطلوبة من الخطوة الأخيرة.

مثال على الطلب

PUT /checkouts/1
                            

{
    "shipping": {
        "handle": "pickup"
    }
}
                            
مثال على الاستجابة

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

إكمال الطلب

طريقة الدفع

حاليًا، طريقة الدفع الوحيدة المتاحة هي الفاتورة.

المستندات - إكمال الطلب

للمطور

قم بتحديث السمة "معالجة الدفع" بواسطة "الفاتورة". يتم تحديد المبلغ الإجمالي من أسعار المنتج وسعر التسليم.

مثال على الطلب

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