API REST xoPort v2.122.13 – Interfaccia JSON

REST · OAuth2 · JSON · v2.122.13

API REST xoPort

La moderna interfaccia JSON per integrazioni automatizzate con i negozi online. Esporta, importa ed elimina i dati in modo sicuro tramite OAuth2 (RFC 6749).

Crea un client OAuth2 Changelog
GET  /Export/JSON/{entity}
POST /Import/JSON/{entity}
PUT  /Import/JSON/{entity}
DELETE /Delete/JSON/{entity}
Nota: l’API REST di xoPort fa parte del modulo aggiuntivo a pagamento XONIC Premium: Interfaccia dati xoPort.
v2.122.13Versione attuale
OAuth2Conforme alla RFC 6749
RESTPOST/PUT/DELETE
JSONRichiesta e risposta

Aree API

L'API REST di xoPort è suddivisa in quattro aree principali:

API di esportazione

Recupera i dati dal negozio: prodotti, categorie, clienti, ordini, notizie e altro ancora.

  • GET /Export/JSON/{entity}
  • Ambito: entity:read
API di esportazione →

API di importazione

Crea e aggiorna i dati nel negozio. A partire dalla v2.1.0 con separazione RESTful POST/PUT.

  • POST /Import/JSON/{entity} = INSERT
  • PUT /Import/JSON/{entity} = UPDATE
  • Ambito: entity:write
API di importazione →

API di eliminazione

Elimina definitivamente i record dal negozio. Richiesta di conferma tramite autorizzazione Scope.

  • DELETE /Delete/JSON/{entity}/{id}
  • Ambito: entity:delete
API di eliminazione →

Autenticazione OAuth2

Flusso delle credenziali del client (RFC 6749) con ambiti altamente granulari per entità e operazione.

  • POST /oauth/token
  • Tipo di autorizzazione: client_credentials
Client OAuth2 →

Guida rapida

3 passaggi per la prima richiesta API:

1

Creare un client OAuth2

Nel backend, alla voce Impostazioni → xoPort → Client OAuth2, creare un nuovo accesso API con gli ambiti richiesti.

2

Ottenere il token di accesso

POST /oauth/token tramite client_id e client_secret. Il token è valido per 1 ora.

3

Inviare le richieste API

Authorization: Bearer {token} Includere l'header in tutte le richieste.

Esempio: esportare le categorie

# 1. Token holen
TOKEN=$(curl -s -X POST "https://shop.de/xpanel/xoport/oauth/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=xoc_xxx" \
  -d "client_secret=xos_xxx" | jq -r '.access_token')

# 2. Kategorien exportieren
curl -s "https://shop.de/xpanel/xoport/Export/JSON/categories" \
  -H "Authorization: Bearer $TOKEN" | jq .

Inizia ora

Crea il tuo primo client OAuth2 e integra i tuoi sistemi.

Crea un client OAuth2

Endpoint

Tutti gli endpoint REST disponibili dell'API xoPort: prodotti, categorie, clienti, produttori, fornitori e altro ancora.

API di esportazione

Esportazione dei dati del negozio tramite GET. Percorsi URL RESTful a partire dalla versione 2.1.0: /categories/{id} restituisce una singola risorsa.

API di importazione

Importazione dei dati del negozio tramite POST (INSERT) e PUT (UPDATE). Separazione RESTful a partire dalla versione 2.1.0 per una semantica chiara.

API di eliminazione

Importazione e aggiornamento dei dati del negozio tramite richieste POST. Logica "upsert", operazioni in blocco fino a 50 record e report dettagliati sugli errori.

Client OAuth2

Creare e gestire client OAuth2 per l'autenticazione sicura alle API secondo il modello Client Credentials Grant (RFC 6749).

Gestione degli errori

Importazione dei dati anagrafici dei clienti per l'integrazione con il CRM. Abbinamento tramite indirizzo e-mail o customers_id.

Registro delle modifiche

Cronologia delle versioni dell'API REST di xoPort: tutte le modifiche, le nuove funzionalità e le correzioni di bug in sintesi.

API JSON xoPort – L'interfaccia moderna per il negozio online

L'API JSON di xoPort consente a sviluppatori e integratori di sistemi di accedere in modo programmatico a tutti i dati rilevanti del XONIC Shop System. Con l'attuale versione 2.122.13, l'API offre non solo operazioni di esportazione, importazione e DELETE sicure, ma anche OAuth2 Client Credentials Grant secondo lo standard RFC 6749 per la massima sicurezza nella comunicazione da server a server.

Perché scegliere l’API JSON di xoPort?

xoPort si basa su standard aperti: metodi HTTP RESTful, payload JSON e autenticazione OAuth2 con ambiti granulari. Ciò garantisce la massima compatibilità con i linguaggi di programmazione e i framework più diffusi, soddisfacendo al contempo i moderni requisiti di sicurezza.

Casi d’uso tipici

  • Integrazione ERP – Sincronizzazione automatica dei prodotti con il sistema di gestione delle scorte
  • Integrazione con i marketplace – Sincronizzazione con Amazon, eBay, Idealo
  • Sistemi PIM – Gestione centralizzata dei dati di prodotto
  • Business Intelligence – Esportazione dei dati per analisi e reportistica
  • Automazione – Pipeline CI/CD per gli aggiornamenti dei contenuti
  • Gestione newsletter – Gestione degli iscritti e delle campagne tramite API
  • Sistema di ticket – Creazione, aggiornamento e gestione dei ticket di assistenza tramite API

OAuth2 in 3 passaggi

  1. Creazione del client: nel backend, in Strumenti → Client OAuth xoPort
  2. Richiedere il token: inviare un POST a /xpanel/xoport/oauth/token
  3. Utilizzare l’API: inserire il token nell’header Authorization: Bearer TOKEN