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	Yalnız spesifikasyon — henüz referans sayfası yok	İş 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 contract'i disabled estimate, RFQ create/list, order create/list ve batch-order sinirlarini yayinlar. Her biri auth sonrasinda capability'ye ozel RFC 9457 503 doner; explorer basarili pricing, RFQ veya order response'u gostermemelidir.

• Base URL: https://api.nowtoprint.com/api/v1
• Kimlik Doğrulama: Authorization: Bearer <ntp_test_* veya ntp_live_* anahtarı>
• En uygun kullanim: auth ve disabled-capability contract kontrolleri

Capability kontrolu

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ış
• 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:

• 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"
  }
}

Makine tarafından okunabilir sözleşme

Preflight Engine için render edilmiş bir referans sayfası yok; doğrudan spesifikasyonu kullanın: /docs/api/preflight-openapi.yaml.

---

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