API Dokümantasyonu

Cloud Print API'yi uygulamanıza entegre etmek için gereken her şey.

Hızlı Başlangıç

1. Hesap oluşturun ve API Key alın.

2. Cloud Print Agent uygulamasını bir bilgisayara kurup giriş yapın.

3. Yazıcılar otomatik olarak API'ye kaydedilir.

4. API Key ile yazdırma isteği gönderin.

Kimlik Doğrulama

Tüm API isteklerinde X-API-Key header'ı veya Authorization: Bearer <jwt> kullanılır.

curl https://teprintapi.lezzetten.com/api/auth/me \
  -H "X-API-Key: pk_your_api_key_here"

Endpoints

Cihazlar

GET/api/devicesTüm cihazları listele

GET/api/devices/:idCihaz detayı + yazıcılar

Yazıcılar

GET/api/printersTüm yazıcıları listele

GET/api/printers/:idYazıcı detayı

Yazdırma İşleri

POST/api/print-jobsYazdırma isteği oluştur

GET/api/print-jobsİşleri listele (filtreli)

GET/api/print-jobs/:idİş detayı

POST/api/print-jobs/:id/retryBaşarısız işi tekrar dene

Yazdırma Örneği

Bir yazıcıya PDF göndermek için önce printerId'yi /api/printers endpointinden alın, ardından aşağıdaki isteği gönderin:

curl -X POST https://teprintapi.lezzetten.com/api/print-jobs \
  -H "X-API-Key: pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "printerId": "PRINTER_ID",
    "documentName": "invoice.pdf",
    "documentData": "BASE64_ENCODED_PDF",
    "copies": 1
  }'

Yanıt

{
  "printJob": {
    "id": "...",
    "status": "queued",
    "documentName": "invoice.pdf",
    "copies": 1,
    "createdAt": "2025-05-08T..."
  }
}

İş Durumları

pendingİstek alındı, henüz kuyruğa eklenmedi

queuedKuyruğa eklendi, sıra bekliyor

processingYazıcıya gönderiliyor

doneYazdırma başarılı

failedYazdırma başarısız (retry ile tekrar denenebilir)