API REST xoPort v2.122.13 – Interface JSON

REST · OAuth2 · JSON · v2.122.13

API REST xoPort

L'interface JSON moderne pour les intégrations automatisées de boutiques en ligne. Exportez, importez et supprimez des données en toute sécurité via OAuth2 (RFC 6749).

Créer un client OAuth2 Journal des modifications
GET  /Export/JSON/{entity}
POST /Import/JSON/{entity}
PUT  /Import/JSON/{entity}
DELETE /Delete/JSON/{entity}
Remarque : l'API REST xoPort fait partie du module complémentaire payant XONIC Premium : interface de données xoPort.
v2.122.13Version actuelle
OAuth2Conforme à la norme RFC 6749
RESTPOST/PUT/DELETE
JSONRequête et réponse

Domaines de l'API

L'API REST xoPort se divise en quatre domaines principaux :

API d'exportation

Lisez les données de la boutique : produits, catégories, clients, commandes, actualités et plus encore.

  • GET /Export/JSON/{entity}
  • Portée : entity:read
API d'exportation →

API d'importation

Créez et mettez à jour des données dans la boutique. Depuis la v2.1.0, avec séparation RESTful POST/PUT.

  • POST /Import/JSON/{entity} = INSERT
  • PUT /Import/JSON/{entity} = UPDATE
  • Portée : entity:write
API d'importation →

API de suppression

Supprimez définitivement des enregistrements de la boutique. Demande de confirmation via l'autorisation Scope.

  • DELETE /Delete/JSON/{entity}/{id}
  • Portée : entity:delete
API de suppression →

Authentification OAuth2

Flux d'informations d'identification du client (RFC 6749) avec des champs d'application très granulaires par entité et par opération.

  • POST /oauth/token
  • Type d'autorisation : client_credentials
Clients OAuth2 →

Démarrage rapide

3 étapes pour effectuer votre première requête API :

1

Créer un client OAuth2

Dans le backend, sous Paramètres → xoPort → Clients OAuth2, créez un nouvel accès API avec les champs d'application requis.

2

Récupérer le jeton d'accès

POST /oauth/token à l'aide de client_id et client_secret. Le jeton est valable 1 heure.

3

Envoyer des requêtes API

Authorization: Bearer {token} Envoyer l'en-tête avec toutes les requêtes.

Exemple : exporter les catégories

# 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 .

Commencer maintenant

Créez votre premier client OAuth2 et intégrez vos systèmes.

Créer un client OAuth2

Terminaux

Tous les points de terminaison REST disponibles de l'API xoPort : produits, catégories, clients, fabricants, fournisseurs et bien plus encore.

API d'exportation

Exportation des données de la boutique via GET. Chemins d'URL RESTful depuis la version 2.1.0 : /categories/ et{id} renvoient une ressource unique.

API d'importation

Importation des données de la boutique via POST (INSERT) et PUT (UPDATE). Séparation RESTful depuis la version 2.1.0 pour une sémantique claire.

API de suppression

Importation et mise à jour des données de la boutique via des requêtes POST. Logique « upsert », opérations en masse jusqu'à 50 enregistrements et rapports d'erreurs détaillés.

Clients OAuth2

Créez et gérez des clients OAuth2 pour une authentification sécurisée via l'API selon le protocole « Client Credentials Grant » (RFC 6749).

Gestion des erreurs

Importation des données de base clients pour l'intégration CRM. Mise en correspondance via l'adresse e-mail ou l'identifiant « customers_id ».

Journal des modifications

Historique des versions de l'API REST xoPort : toutes les modifications, les nouvelles fonctionnalités et les corrections de bogues en un coup d'œil.

API JSON xoPort – L'interface moderne pour les boutiques en ligne

L'API JSON xoPort permet aux développeurs et aux intégrateurs système d'accéder par programmation à toutes les données pertinentes de la boutique en ligne du XONIC Shop System. Avec la version actuelle 2.122.13, l’API propose non seulement des opérations d’exportation, d’importation et de suppression sécurisées, mais aussi le protocole OAuth2 Client Credentials Grant conforme à la norme RFC 6749 pour une sécurité maximale lors des communications de serveur à serveur.

Pourquoi choisir l’API JSON xoPort ?

xoPort repose sur des normes ouvertes : méthodes HTTP RESTful, charges utiles JSON et authentification OAuth2 avec des périmètres d’accès granulaires. Cela garantit une compatibilité maximale avec les langages de programmation et les frameworks courants, tout en répondant aux exigences de sécurité modernes.

Cas d’utilisation typiques

  • Intégration ERP – Synchronisation automatique des produits avec le système de gestion des stocks
  • Connexion aux places de marché – Synchronisation avec Amazon, eBay, Idealo
  • Systèmes PIM – Gestion centralisée des données produits
  • Business Intelligence – Exportation de données pour l’analyse et le reporting
  • Automatisation – Pipelines CI/CD pour les mises à jour de contenu
  • Gestion des newsletters – Gestion des abonnés et des campagnes via l’API
  • Système de tickets – Création, mise à jour et gestion des tickets d'assistance via l'API

OAuth2 en 3 étapes

  1. Créer un client : dans le backend, sous Outils → Clients OAuth xoPort
  2. Demander un jeton : envoi d’une requête POST à /xpanel/xoport/oauth/token
  3. Utiliser l’API : indiquer le jeton dans l’en-tête Authorization: Bearer TOKEN