Printiturk Özel API Entegrasyonu

Kendi yazılım altyapınız veya e-ticaret siteniz (WooCommerce harici özel siteler, Shopify, özel sistemler) üzerinden aldığınız siparişleri tam otomatik olarak Printiturk üretim bandına yönlendirebilirsiniz. API'miz tasarım kaydetme, sipariş oluşturma ve anlık kargo/durum takibi yapma yeteneklerine sahiptir.

Yetkilendirme (Authentication)

Printiturk API isteklerinizi doğrulayabilmek için her istekte HTTP başlığına (Header) API Erişim Anahtarınızı (Token) Bearer biçiminde eklemelisiniz.

Authorization: Bearer YOUR_API_TOKENContent-Type: application/json

Binlerce hazır tasarımınızı veya dinamik olarak ürettiğiniz görselleri tek tek panele yüklemek yerine API üzerinden toplu halde kaydedebilirsiniz. Yanıt olarak alacağınız PT-DSG-XXXX kodunu sipariş gönderirken doğrudan product_sku alanında kullanabilirsiniz.

{
  "title": "Siyah Kedi Tasarımı",
  "user_sku": "MY-CAT-001",
  "image_url": "https://siteniz.com/uploads/kedi.png",
  "side": "front",
  "width_cm": 25
}

{
  "success": true,
  "message": "Tasarım başarıyla kaydedildi.",
  "design_id": "PT-DSG-1945",
  "id": 1945,
  "user_sku": "MY-CAT-001",
  "title": "Siyah Kedi Tasarımı",
  "side": "front"
}

Dış sisteminizde oluşan siparişi Printiturk'e göndermek için bu uç noktayı kullanın. Sistem, göndereceğiniz SKU kodlarını otomatik olarak eşleştirir, dinamik baskı maliyetlerini hesaplar ve siparişi "Ödeme Bekliyor" (awaiting_payment) durumunda kuyruğa alır.

{
  "external_order_id": "WEB-9872",
  "cargo_label_url": "https://siteniz.com/labels/kargo_label_9872.pdf",
  "customer": {
    "first_name": "Can",
    "last_name": "Kaya",
    "email": "cankaya@example.com",
    "phone": "5320000000",
    "address": "Moda Cad. Huzur Apt. No:12 D:4",
    "city": "İstanbul",
    "district": "Kadıköy"
  },
  "items": [
    {
      "product_sku": "ESP-BSC-ERK-TSH",
      "quantity": 1,
      "size": "L",
      "color": "Siyah",
      "side": "front",
      "width_cm": 30,
      "design_url": "https://siteniz.com/uploads/baski_dosyasi.png",
      "mockup_url": "https://siteniz.com/uploads/bitmis_urun_mockup.jpg"
    }
  ]
}

{
  "success": true,
  "message": "1 adet ürün başarıyla sipariş olarak alındı.",
  "order_numbers": [
    "#ORD-34986"
  ],
  "status": "awaiting_payment"
}

Printiturk'e göndermiş olduğunuz bir siparişin güncel üretim durumunu ve kargoya verildiyse kargo takip bilgilerini almak için bu endpoint'i kullanın.

GET /orders.php?order_id=%23ORD-34986 HTTP/1.1
Host: www.printiturk.comAuthorization: Bearer YOUR_API_TOKEN

{
  "success": true,
  "order_id": "#ORD-34986",
  "status": "shipped",
  "status_description": "Kargoya Verildi",
  "cargo_label_url": "https://siteniz.com/labels/kargo_label_9872.pdf",
  "tracking": {
    "number": "33485029192",
    "url": "https://geliver.io/takip/33485029192"
  }
}

Hatalar ve Yanıt Kodları

İsteklerin başarısız olması durumunda API standart HTTP durum kodları ile birlikte hatanın sebebini açıklayan bir JSON yanıtı döner.

SKU Eşleştirme Kuralları