Sviluppa con l'API PrintKK
Inizia con l'autenticazione tramite firma, quindi implementa il caricamento delle immagini, la creazione di design, la creazione di ordini e l'elaborazione dei pagamenti tramite endpoint REST.
Funzionalità principali dell'API
Concentrati sul flusso di produzione essenziale, dalle risorse al pagamento, basato sui gruppi di endpoint documentati.
Firma e autenticazione
Utilizza le specifiche di firma e autenticazione per proteggere ogni richiesta e controllare l'accesso alle tue operazioni API.
Caricare immagini
Carica risorse di design tramite gli endpoint immagine e prepara i file per la generazione successiva dei design.
Creare design
Crea dati di design con gli endpoint di design e organizza i parametri richiesti per un output pronto per la produzione.
Creare e pagare ordini
Invia payload di ordine e completa i pagamenti tramite gli endpoint di ordine per chiudere il flusso di transazione.
Flusso di integrazione API
Dalla prima chiamata autenticata all'ordine pagato, questo percorso in quattro fasi rispecchia come le nostre API sono raggruppate nella documentazione: accesso sicuro, risorse immagine, design stampabili, poi checkout e pagamento. Tratta ogni fase come un punto di controllo in modo che il tuo backend rimanga prevedibile e facile da debuggare.
Configurare firma e autenticazione
Leggi i capitoli su firma e autenticazione, emetti o importa le credenziali necessarie per il tuo ambiente e implementa la firma esattamente come specificato. Invia alcune richieste di test a basso rischio e conferma di ricevere risposte positive prima di procedere con i caricamenti -- quando l'autenticazione è solida, gli errori successivi puntano quasi sempre alla struttura del payload piuttosto che a misteriosi errori 401.
Caricare le immagini necessarie per i tuoi prodotti
Utilizza gli endpoint immagine per caricare loghi, opere d'arte o altri file richiesti dalla tua integrazione. Memorizza ogni identificatore restituito nella risposta API in modo da poter passare quei valori alle successive richieste di design, nella stessa forma mostrata negli esempi di richiesta.
Creare e persistere i record di design
Chiama gli endpoint di design per creare record di design che combinano prodotti, posizionamenti e riferimenti immagine dal passaggio precedente. Conserva gli identificatori di design restituiti nel tuo sistema in modo che i payload degli ordini possano farvi riferimento, come descritto nella sezione Ordine della documentazione.
Inviare l'ordine e completare il pagamento
Invia ordini tramite gli endpoint di ordine utilizzando gli identificatori di design memorizzati. Completa il pagamento seguendo i passaggi documentati per gli endpoint relativi al pagamento. Risposte, codici di stato e corpi di errore nella documentazione fanno fede -- non fare affidamento su comportamenti non descritti lì.
Oltre il percorso di integrazione principale
La documentazione ufficiale dell'API raggruppa anche Prodotto, Generale, FAQ e Changelog insieme ad Autenticazione, Immagine, Design e Ordine. Utilizza queste sezioni quando hai bisogno di dati di catalogo, utility condivise o cronologia delle versioni che il flusso principale non copre da solo.
-
Prodotto
Gli endpoint Prodotto descrivono come interrogare articoli di catalogo, varianti e opzioni che si abbinano a design e ordini. Consultali quando devi risolvere ID prodotto o attributi prima di costruire un payload.
-
Generale
La sezione Generale copre utility e richieste trasversali che affiancano le chiamate di immagine, design e ordine. Controlla il riferimento quando hai bisogno di operazioni helper documentate lì.
-
FAQ e Changelog
Leggi le FAQ per domande comuni sull'integrazione e utilizza il Changelog per tenere traccia degli aggiornamenti API, delle aggiunte e di eventuali cambiamenti incompatibili nel tempo.
Casi d'uso API comuni
Pattern di implementazione tipici basati sulle capacità di immagine, design e ordine.
Pipeline di design automatizzata
Carica immagini in batch e genera design programmaticamente per accelerare la produzione di contenuti.
Servizio di invio ordini
Costruisci un servizio backend che converte i dati di checkout in richieste di ordine standardizzate.
Flusso di completamento pagamento
Connetti gli endpoint di creazione ordine e pagamento in una sequenza di transazione controllata con una gestione chiara degli stati.
Risorse per i team
Utilizza la documentazione e i canali di supporto per accelerare lo sviluppo e il rollout.
Documentazione per sviluppatori
Rivedi i gruppi di endpoint, i dettagli di autenticazione e gli esempi di payload per le operazioni di immagine, design e ordine.
Apri documentazioneSupporto tecnico
Contatta il team PrintKK per domande sull'implementazione e risoluzione dei problemi di integrazione.
FAQ API
Cosa dovremmo implementare per primo?
Inizia con firma e autenticazione in modo che ogni successiva richiesta di immagine, design e ordine sia verificabile e sicura.
Quali operazioni principali sono supportate?
Le operazioni principali documentate sono il caricamento immagini, la creazione di design, la creazione di ordini e il pagamento degli ordini.
Come dovremmo strutturare la sequenza di chiamate?
Utilizza un flusso lineare: autenticare le richieste, caricare le immagini, creare i design, creare gli ordini, quindi completare il pagamento.
Dove possiamo trovare i dettagli delle richieste?
Consulta la documentazione API per i parametri degli endpoint, gli esempi di richieste e le note di implementazione specifiche per sezione.
Inizia l'integrazione oggi stesso
Apri la documentazione API per visualizzare le regole di firma, i parametri degli endpoint e gli esempi di richieste per ogni funzionalità.
