Genel Baskı Dosyaları API'si

Temel URL: https://app.customix.io/api

Kimlik doğrulama: Customix API anahtarı nasıl alınır

Authorization: Bearer {your-api-token}

Hız sınırı: dakikada 100 istek (kullanıcı başına)

Genel bakış

Bir ürün özelleştirmesini düz, çok satırlı metin olarak gönderin ve o gönderim için
baskı dosyası URL'lerinin listesini geri alın.

Baskı dosyaları oluşturma

POST /print-files

İstek gövdesi

AlanTürZorunluAçıklama
shop_namestringEvetMağaza adınız (örneğin my-etsy-shop)
namestringEvetBu mağazada sahip olduğunuz bir şablonun adı. Ada uyan ilk şablon kullanılır.
contentstringEvetÇok satırlı özelleştirme. Her satır <option name>: <value> biçimindedir. Baştaki - isteğe bağlıdır.

İçerik biçimi

Her satır, şablondaki özelleştirilebilir bir seçeneği bir değerle eşler.

  • Seçenek adları büyük/küçük harfe duyarsız olarak eşleştirilir ve çevresindeki boşluklar yok sayılır.
  • Metin / renk / tarih seçenekleri değeri olduğu gibi alır, örneğin

Harry, #ffffff, 2026-12-25.

  • Renk örneği seçenekleri (yazı tipi, görsel, renk, düzen vb.), mevcut renk örneği değerlerinden birini

seçen bir tam sayı alır. Varsayılan olarak 1 ilk değeri,
2 ikinci değeri seçer ve bu şekilde devam eder.

Örnek:

- Enter your name: Harry
- Text color: #ffffff
- Font: 1

Yanıt 201

{
  "id": "01jyz5kqxz2hrcwqzdq4jdv7r9",
  "print_file_urls": [
    "https://.../1.png",
    "https://.../2.png"
  ]
}
AlanTürAçıklama
idstringGönderimin tanımlayıcısı
print_file_urlsstring[]Şablondaki her baskı dosyası için bir URL, şablon sırasına göre

Baskı dosyaları, oluşturma işlemi tamamlandığında döndürülen URL'lerde kullanılabilir hale gelir
(genellikle yanıttan birkaç saniye sonra).

Hata yanıtları

DurumGövdeNeden
401{"message": "Unauthenticated."}Eksik veya geçersiz bearer belirteci
403{"message": "Unauthenticated"}Belirteç geçerli ancak çağıranın shop_name için erişimi yok
404{"message": "Template not found: …"}Bu mağazada o name değerine sahip bir şablon yok
422{"errors": {"shop_name": […], "name": […], "content": […]}}Zorunlu alanlar eksik
422{"message": "Unknown option: <name>"}Bir satır, şablonda bulunmayan bir seçeneğe başvuruyor
422{"message": "Swatch index N is out of range for option '…' …"}Renk örneği dizini, kullanılabilir aralığın dışında
422{"message": "Option '…' expects an integer swatch index, got …"}Bir renk örneği seçeneğine tam sayı olmayan bir değer iletildi

Örnek istek

curl -X POST 'https://app.customix.io/api/print-files' \
  -H 'Authorization: Bearer 01jyz0z…|abc…' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "shop_name": "my-etsy-shop",
    "name": "My Template",
    "content": "- Enter your name: Harry\n- Text color: #ffffff\n- Font: 1"
  }'

Güncelleme tarihi: 20/05/2026