API dokümantasyonu

Hızlı başlangıç

1. Hesap oluştur veya giriş yap.
2. Hesabım sayfasından bir API anahtarı oluştur. Anahtar yalnızca oluşturulduğu anda gösterilir; kopyala.
3. Aşağıdaki "API'yi dene" bölümüne anahtarı yapıştırıp bir etiket gönder, ya da kendi sisteminden POST /convert çağır.

İlk isteğin

Bir ZPL etiketini PNG olarak almak için tek istek yeter. Dört dilde de aynı sonucu verir.

curl -X POST 'https://zpl.podyumplus.com/convert' \
  -H 'X-API-Key: <ANAHTAR>' \
  -H 'Content-Type: text/plain; charset=utf-8' \
  --data-raw '^XA^CI28^FO40,40^A0N,40,40^FDAlıcı: Ahmet Yılmaz^FS^XZ' \
  -o etiket.png

import fs from 'node:fs';

const res = await fetch('https://zpl.podyumplus.com/convert', {
  method: 'POST',
  headers: { 'X-API-Key': '<ANAHTAR>', 'Content-Type': 'text/plain; charset=utf-8' },
  body: '^XA^CI28^FO40,40^A0N,40,40^FDAlıcı: Ahmet Yılmaz^FS^XZ',
});
if (!res.ok) throw new Error((await res.json()).error);
fs.writeFileSync('etiket.png', Buffer.from(await res.arrayBuffer()));

<?php
$ch = curl_init('https://zpl.podyumplus.com/convert');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => '^XA^CI28^FO40,40^A0N,40,40^FDAlıcı: Ahmet Yılmaz^FS^XZ',
    CURLOPT_HTTPHEADER     => ['X-API-Key: <ANAHTAR>', 'Content-Type: text/plain; charset=utf-8'],
    CURLOPT_RETURNTRANSFER => true,
]);
file_put_contents('etiket.png', curl_exec($ch));

import requests

res = requests.post(
    'https://zpl.podyumplus.com/convert',
    headers={'X-API-Key': '<ANAHTAR>', 'Content-Type': 'text/plain; charset=utf-8'},
    data='^XA^CI28^FO40,40^A0N,40,40^FDAlıcı: Ahmet Yılmaz^FS^XZ'.encode('utf-8'),
    timeout=30,
)
res.raise_for_status()
open('etiket.png', 'wb').write(res.content)

Yanıt başarılıysa PNG dosyası gelir. Hata olursa {"error": "..."} JSON'u döner; hata kodları aşağıda.

Kimlik doğrulama

Her /convert isteğinde X-API-Key başlığı gerekir. Anahtar, hesabınıza bağlıdır ve günlük kullanım hakkı hesap başına sayılır.

X-API-Key: zpl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Uç noktalar

Parametreler

Etiket boyutu ZPL içindeki ^PW (genişlik) ve ^LL (yükseklik) değerlerinden alınır. Belirtilmemişse 4×6 inç kullanılır. Türkçe karakterler için etikette ^CI28 kullanmak gerekmez; kodlama belirtilmemişse UTF-8 varsayılır.

Yanıtlar ve hatalar

Başarılı yanıt (200)

Varsayılan: ilk etiketin PNG'si, Content-Type: image/png. Yanıt başlığı X-Label-Count toplam etiket sayısını verir.

{
  "count": 2,
  "labels": [
    { "width": 812, "height": 600, "png_base64": "iVBORw0KGgo..." },
    { "width": 812, "height": 600, "png_base64": "iVBORw0KGgo..." }
  ]
}

Hata yanıtları

Hatalar her zaman {"error": "..."} biçiminde JSON olarak döner.

Sınırlar

• İstek başına: en fazla 512 KB gövde ve 10 etiket.
• Günlük kullanım: hesap başına 100 istek (her /convert isteği bir hak sayılır). Limit UTC gece yarısında sıfırlanır.
• Çizim süresi: etiket başına en fazla 5 saniye.
• Eşzamanlılık: sunucu aynı anda birkaç çizim yapar; yoğunlukta 503 dönebilir.

Kod örnekleri

cURL, JavaScript, PHP ve Python örnekleri için ana sayfadaki API bölümüne bak. Hızlı bir cURL örneği:

curl -X POST 'https://zpl.podyumplus.com/convert?dpmm=8' \
  -H 'X-API-Key: <ANAHTAR>' \
  -H 'Content-Type: text/plain' \
  --data-raw '^XA
^CI28
^FO40,40^A0N,40,40^FDAlıcı: Ahmet Yılmaz^FS
^XZ' \
  -o etiket.png

API'yi dene

Anahtarını gir, bir etiket gönder ve sonucu burada gör. İstekler doğrudan bu sunucuya gider; anahtar tarayıcı dışına çıkmaz ve sayfa kapandığında silinir.

Eşdeğer cURL