API Referansı
NowToPrint üç API yüzeyi sunar: Partner REST API, XJDF/PrintTalk entegrasyon katmanı ve Preflight motor API'si. Bu sayfa her yüzeyin OpenAPI spesifikasyonunu ve entegrasyon rehberlerini listeler.
API Referansı
NowToPrint üç farklı API yüzeyi sunar. Entegrasyon hedefinize uygun olanı seçin.
API Yüzeyleri
Partner REST API
Kendi uygulamanızdan programatik olarak RFQ oluşturun, teklifler alın ve baskı siparişleri verin. API anahtarı kimlik doğrulaması gerektirir.
XJDF / PrintTalk API
MIS/ERP sistemleri ve matbaa iş akışı yazılımları için CIP4 XJDF 2.2 ve PrintTalk 2.2 uyumlu B2B entegrasyon katmanı.
Preflight Motor API
PDF dosyalarını otomatik kalite kontrolüne gönderin ve yapılandırılmış raporlar alın — DPI, bleed, renk modu, font gömme.
OpenAPI Spesifikasyonları
Her API yüzeyi, herhangi bir API istemcisine (Postman, Insomnia, Bruno vb.) içe aktarabileceğiniz makine tarafından okunabilir bir OpenAPI spesifikasyonu ile belgelenmiştir.
| API | Sürüm | Spec Dosyası | İnteraktif Dokümantasyon |
|---|---|---|---|
| Partner REST API | v1 | openapi.yaml | Swagger UI |
| XJDF / PrintTalk API | v1 | xjdf-openapi.yaml | — |
| Preflight Motor API | v1 | preflight-openapi.yaml | — |
OpenAPI-öncelikli geliştirme
Üç spesifikasyon da API sözleşmeleri için gerçeğin tek kaynağı olarak korunmaktadır. Partner API için interaktif Swagger UI, kod yazmadan doğrudan tarayıcınızdan istekleri denemenize olanak tanır.
Kimlik Doğrulama
Partner REST API — API Anahtarı
Tüm Partner API istekleri bir X-API-Key başlığı gerektirir. Anahtarınızı organizasyon ayarlarınızın Geliştirici bölümünden edinin.
GET /api/v1/rfq HTTP/1.1
Host: api.nowtoprint.com
X-API-Key: np_live_xxxxxxxxxxxxxxxxxxxxXJDF / PrintTalk — mTLS veya API Anahtarı
B2B entegrasyonlar karşılıklı TLS (mTLS) sertifika kimlik doğrulamasını veya API anahtarını destekler. Ayrıntılar için XJDF Entegrasyon Rehberi'ne bakın.
Hız Sınırları
| API | Limit | Pencere |
|---|---|---|
| Partner REST API | 100 istek | Dakika başına |
| Partner REST API | 1.000 istek | Saat başına |
| Preflight Motor API | 20 gönderim | Dakika başına |
Limit aşıldığında API, Retry-After başlığı ile birlikte HTTP 429 Too Many Requests döner.
SDK ve Entegrasyon Örnekleri
Depo, yaygın entegrasyon kalıpları için çalışmaya hazır örnekler içerir:
- Node.js / TypeScript — tam RFQ yaşam döngüsü (oluştur → teklif → kabul et)
- Python — Partner API üzerinden toplu sipariş gönderimi
- cURL — üç API yüzeyi için minimal örnekler
Depodaki docs/api/examples/ klasörüne bakın.
Sürümleme Politikası
- Tüm API yüzeyleri için geçerli kararlı sürüm v1'dir
- Kırıcı değişiklikler yeni bir ana sürümde (
/api/v2/) sunulacaktır - v2 yayınlandıktan sonra v1 en az 12 ay daha desteklenecektir
- Kullanımdan kaldırma bildirimleri, kayıtlı API anahtarı kişilerine en az 90 gün öncesinden gönderilir
İlgili Rehberler
İlgili makaleler
Bu makale yardımcı oldu mu?