OpenAPI Explorer ve Spec Referansı

Bu sayfayı NowToPrint makine tarafından okunabilir sözleşmeleri için tek genel dizin olarak kullanın. Her yüzeyin bir kanonik indirme URL'si ve operasyonel bağlam için eşleşen bir rehberi bulunur.

---

Yayınlanan Kaynaklar

Kaynak	Genel URL	Oluşturulan referans	En uygun kullanım
Partner REST API sözleşmesi	/docs/api/openapi.yaml	Partner REST API	Postman import, SDK üretimi ve QA sözleşme incelemesi
XJDF / PrintTalk sözleşmesi	/docs/api/xjdf-openapi.yaml	XJDF & PrintTalk API	Standart entegrasyonlar ve yetenek araçları
Preflight Engine sözleşmesi	/docs/api/preflight-openapi.yaml	Preflight Engine API	İş gönderimi ve durum sorgulama için kuyruğa alınmış PDF inceleme istemcileri
XJDF Swagger önizlemesi	/docs/api/swagger-ui.html	XJDF entegrasyon rehberi	XJDF sözleşmesinin tarayıcı tabanlı incelenmesi

---

Partner REST API

Genel Bakış

Partner API, alıcılar, ajanslar, beyaz etiket ortakları ve pazar yerleri için birincil ticari entegrasyon yüzeyidir.

• Base URL: https://api.nowtoprint.com/api/v1
• Kimlik Doğrulama: Authorization: Bearer <ntp_test_* veya ntp_live_* anahtarı>
• En uygun kullanım: tahminler, teklif talepleri (RFQ), teklif kabulü, siparişler ve operasyonel webhook'lar

İlk istek

curl -X POST https://api.nowtoprint.com/api/v1/estimate \
  -H "Authorization: Bearer ntp_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "business_cards",
    "quantity": 500,
    "specifications": {
      "paperType": "coated-matte"
    }
  }'

Sonraki okumalar

• Partner API genel bakış
• Partner REST API referansı
• Başlangıç rehberi
• Kimlik doğrulama

---

XJDF / PrintTalk API

Genel Bakış

XJDF ve PrintTalk katmanı, MIS, ERP ve iş akışı sistemleriyle standart tabanlı birlikte çalışabilirlik için tasarlanmıştır.

• Route ailesi: https://api.nowtoprint.com/api/v1/xjdf
• Kimlik Doğrulama: bearer auth veya X-API-Key, seçili kurumsal yapılarda mTLS desteği
• En uygun kullanım: standart tabanlı iş alışverişi, yetenek keşfi ve harici iş akışı uyumu

Tarayıcıda keşfedin

Spec dosyasını import etmeden önce kullanıcı dostu bir sözleşme incelemesine ihtiyaç duyduğunuzda yayınlanan önizlemeyi kullanın:

• XJDF & PrintTalk API referansı
• Swagger UI önizlemesi
• Entegrasyon rehberi
• Master data modeli

---

Preflight Engine API

Genel Bakış

Preflight yüzeyi, PDF incelemesi, iş gönderimi ve durum sorgulama için kuyruğa alınmış doğrulama sözleşmesidir.

• Route ailesi: https://api.nowtoprint.com/api/v1
• Kimlik Doğrulama: bearer token
• En uygun kullanım: otomatik dosya doğrulama, teknik kalite kontrolleri ve eşzamansız analiz

Örnek istek

POST /api/v1/preflight HTTP/1.1
Host: api.nowtoprint.com
Authorization: Bearer ntp_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "fileUrl": "https://cdn.example.com/artwork.pdf",
  "profile": "print_ready"
}

Örnek yanıt yapısı

{
  "jobId": "pref_01js3q7d9w4b2k8m1z0h3v6x7y",
  "status": "queued",
  "submittedAt": "2026-04-16T10:00:00.000Z",
  "links": {
    "self": "/api/v1/preflight/pref_01js3q7d9w4b2k8m1z0h3v6x7y"
  }
}

Oluşturulan referans

• Preflight Engine API referansı

---

Sorun detayları ve yeniden denemeler

NowToPrint, entegrasyon hatalarını yapılandırılmış HTTP yanıtları aracılığıyla sunar. Genel olarak:

• 400 yük veya şema uyumsuzluğu anlamına gelir
• 401 eksik veya geçersiz kimlik bilgileri anlamına gelir
• 403 kapsam veya yetki uyumsuzluğu anlamına gelir
• 429 geri çekilin ve Retry-After başlığına güvenin anlamına gelir
• 5xx geçici hata veya bağımlılık kesintisi anlamına gelir

Loglarda istek kimliklerini kullanın, yazma işlemlerini idempotent tutun ve üretime geçmeden önce webhook'ları bağlayın.

---

Değişiklik yönetimi

• Partner API genel sözleşmesi: v1
• XJDF entegrasyon katmanı: güncel genel v1
• Preflight yüzeyi: güncel genel v3
• Kırılma değişiklikleri için yeni ana route aileleri kullanılır
• Genel sözleşme dosyaları, harici entegrasyon rehberi değişikliklerinden önce güncellenir

---

İlgili: API Referansı | Partner API | XJDF API | Webhook Erişimi ve Teslimat