Endpoint
Ogni rotta dell'API per i commercianti, dal documento OpenAPI. Le rotte della pagina dello shop ricevono la chiave pubblicabile in ?key=; le due rotte del server ricevono la chiave segreta in Authorization: Bearer.
URL di base https://cfg.cutoptim.com · Versione del contratto v1 · Documento OpenAPI 3.1
Percorsi, nomi dei campi, codici di errore, nomi degli header ed esempi di codice restano in inglese: sono il contratto.
Tutte le rotte
La tabella è generata dal documento OpenAPI; il riferimento interattivo qui sotto mostra lo stesso documento con ogni schema ed esempi di codice. Punta il tuo generatore di client al documento stesso.
| Metodo | Percorso | Chiave | Cosa fa |
|---|---|---|---|
| GET | /cfg/v1/config/public | pubblicabile | The shop's published configuration (public projection) |
| GET | /cfg/v1/catalog/search | pubblicabile | Search the shop's catalogue |
| POST | /cfg/v1/preview | pubblicabile | Live plan and price (not billable, no token) |
| POST | /cfg/v1/quote | pubblicabile | Signed quote (billable) |
| POST | /cfg/v1/order | pubblicabile | Redeem a quote once and store the signed order.v1 |
| POST | /cfg/v1/projects | pubblicabile | Save a project |
| GET | /cfg/v1/projects | pubblicabile + token di progetto | The shopper's projects (newest first, without data) |
| GET | /cfg/v1/projects/{id} | pubblicabile + token di progetto | Open one project (with data) |
| POST | /cfg/v1/projects/{id} | pubblicabile + token di progetto | Re-save a project (name and/or data) |
| POST | /cfg/v1/projects/{id}/duplicate | pubblicabile + token di progetto | Copy a project (new id, same data, same owner) |
| POST | /cfg/v1/projects/{id}/reorder | pubblicabile + token di progetto | A new quote from a saved project, at today's prices |
| POST | /cfg/v1/quote/verify | segreta | Verify a quote token before the cart (read-only) |
| GET | /cfg/v1/orders/{id} | segreta | Check a stored order (no personal data) |
Il riferimento interattivo si carica qui sotto. Senza JavaScript, leggi la tabella qui sopra o il documento OpenAPI. /configurator/openapi.json
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)