Riferimento API del Configurator
L'API per i commercianti del CutOptim Configurator: le chiamate che l'embed esegue dalla pagina del tuo shop, i due controlli che il tuo server effettua prima che qualcosa arrivi in un carrello, e i webhook firmati che il tuo server riceve quando un ordine viene effettuato o cambia stato.
URL di base https://cfg.cutoptim.com · Versione del contratto v1 · Documento OpenAPI 3.1
Accesso anticipato: l'API per i commercianti è pronta e si può provare in uno shop sandbox; i plug-in per le piattaforme di e-commerce sono ancora in sviluppo. CutOptim non incassa alcun pagamento: il carrello, il checkout e il pagamento restano nel tuo shop.
Riferimento API →Riferimento completo della CutOptim Engine API: endpoint, struttura di richiesta e risposta, tutte le opzioni, codici di errore, motori, versionamento e limiti.Tre regole dietro ogni integrazione
L'integrazione è piccola, ma tre regole decidono se è sicura. Ogni pagina di questo riferimento torna su di esse.
- Il prezzo arriva dal servizio, mai dal browser. L'embed mostra un prezzo che il servizio ha calcolato dalla tua configurazione pubblicata; un numero in un evento del browser non dimostra nulla.
- Il tuo server verifica prima del carrello. Invia il token del preventivo a
POST /cfg/v1/quote/verifycon la tua chiave segreta e recupera l'ordine conGET /cfg/v1/orders/{id}. - Un webhook è attendibile solo dopo che la sua firma risulta valida sui byte grezzi che hai ricevuto, e viene elaborato una sola volta per ogni id evento.
Da dove iniziare
Sei nuovo al Configurator? Leggi prima la Guida rapida, poi Chiavi e autenticazione. La pagina Endpoint elenca ogni rotta; il documento OpenAPI che sta dietro è il contratto leggibile da una macchina che il tuo generatore di codice può leggere.
Qui non c'è un pulsante "provalo" di proposito: la chiave segreta appartiene al tuo server, mai a un browser. Lo shop demo mostra l'incorporamento e il passaggio dell'ordine in funzione da un capo all'altro.
Note legaliCondizioni del configuratore (EN) ·Accordo sul trattamento dei dati (EN) ·Informativa privacy per gli acquirenti ·Licenze di terze parti (EN)