Scopio

Bâtir avec l'API
Scopio.

API REST, UCP, Serveur MCP, flux XML/JSON, Calendrier et Analytics — tout ce dont les agents IA et les systèmes ERP ont besoin pour se connecter au marché européen Scopio.

Clé API Bearer

Tous les points de terminaison nécessitent un jeton Bearer. Générez votre clé dans Paramètres du compte → Intégrations → Clés API. Format: sk_mkt_...

En-têteAuthorization: Bearer sk_mkt_YOUR_KEY
Content-Typeapplication/json
URL de basehttps://business.scopio.pl

Test rapide — curl

curl -X POST \
  https://business.scopio.pl/api/seller/products \
  -H "Authorization: Bearer sk_mkt_..." \
  -H "Content-Type: application/json" \
  -d '[{"ean":"8721199108286","price":29.99,"qty":10}]'

Réponse

{"updated":1,"pending_review":0,"errors":0}

6 méthodes d'intégration

Toutes les méthodes acceptent EAN + prix + quantité. Choisissez celle qui correspond à votre pile technique.

Native

REST API

Synchro JSON en temps réel. Tableau de produits, jusqu'à 10 000 par requête. Les EAN de notre catalogue sont immédiatement en ligne.

POST /api/seller/products
[{"ean":"8721199108286","price":29.99,"qty":10}]
Standard

XML Feed

Téléverser le catalogue XML. Format générique et Google Shopping RSS pris en charge. Idéal pour les systèmes ERP.

POST /api/seller/products/xml
{"url":"https://yourshop.pl/feed.xml"}
URL Sync

JSON Feed

Indiquez-nous l'URL de votre flux JSON. Nous le récupérerons et l'analyserons automatiquement de manière régulière.

POST /api/seller/products/json-feed
{"url":"https://yourshop.pl/products.json"}
Offline

Excel / XLSX

Téléverser un fichier Excel. Colonnes requises : EAN, Prix, Quantité. Aucune compétence en programmation requise.

POST /api/seller/products/xlsx
multipart/form-data: file=products.xlsx
FTP

FTP Transfer

Enregistrez les identifiants FTP une fois. Nous récupérons votre fichier de produits (JSON, XML ou CSV) à la demande.

POST /api/seller/products/ftp
{"host":"ftp.yourshop.pl","user":"u","pass":"p","path":"/products.json"}
AI Ready

MCP Server

Standard JSON-RPC 2.0 pour les agents IA. Claude, ChatGPT et Gemini peuvent appeler directement les outils de base de données.

POST /api/seller/products/mcp
{"jsonrpc":"2.0","method":"sync_products","params":{...},"id":1}

Format de réponse

"updated": N

EAN correspondants → en ligne immédiatement sur le marché

"pending_review": N

EAN inconnus → mis en attente pour vérification Google Merchant

"errors": N

Erreurs de validation avec détails par produit

Serveur MCP

Point de terminaison JSON-RPC 2.0. Claude, ChatGPT, Gemini et tout autre agent appellent directement les outils de Scopio — pas d'exportation manuelle requise.

sync_products

Transmet le tableau de produits au marché. Renvoie le nombre de produits mis à jour, en attente de révision, et erronés.

params: {"products": [{"ean": "string", "price": number, "qty": number}]}
check_ean

Vérifie l'EAN dans le catalogue Scopio. Renvoie le statut : live | pending | unknown.

params: {"ean": "string"}
get_offers

Récupère les offres actuellement actives sur le marché pour le vendeur authentifié.

params: {}

Point de terminaison

POST /api/seller/products/mcp

Exemple de requête

{
  "jsonrpc": "2.0",
  "method": "sync_products",
  "params": {
    "products": [
      {"ean":"8721199108286","price":29.99,"qty":10}
    ]
  },
  "id": 1
}

Réponse

{
  "jsonrpc": "2.0",
  "result": {"updated":1,"pending_review":0,"errors":0},
  "id": 1
}

Réservation via Agent IA

Permet aux agents IA de vérifier la disponibilité et de réserver des réunions de manière autonome au nom des clients.

Obtenir les créneaux disponibles

GET /api/calendar/slots?date=2025-06-15&duration=30

Renvoie : [{slot_id, start, end, available}]

Réserver un créneau

POST /api/calendar/book
{
  "slot_id": "...",
  "client_name": "Jan Kowalski",
  "client_email": "jan@firma.pl",
  "service_name": "Demo call",
  "duration": 30
}
Analyses IA

Statistiques de trafic IA

Découvrez combien de fois Claude, ChatGPT, Gemini et d'autres agents ont interagi avec vos produits.

GET /api/seller/analytics
{
  "total_30d": 142,
  "by_type": {
    "mcp_query": 98,
    "product_query": 31,
    "calendar_booking": 13
  },
  "by_agent": {
    "claude": 67,
    "chatgpt": 44,
    "gemini": 31
  },
  "trend_7d": [
    {"date":"2026-05-20","count":12}, ...
  ],
  "top_products": [
    {"ean":"8721199108286","count":23}
  ]
}

Webhooks entrants

Configurez une URL de webhook dans votre panneau. Nous enverrons des notifications POST sur les événements (par exemple, order.placed) en temps réel.

Enregistrer un webhook

POST /api/seller/webhooks
{
  "url": "https://yourshop.pl/scopio-hook",
  "events": ["order.placed","product.updated"]
}

Données utiles — order.placed

{
  "event": "order.placed",
  "order_id": "ORD-2026-...",
  "ean": "8721199108286",
  "qty": 2,
  "buyer_country": "DE",
  "created_at": "2026-05-26T12:00:00Z"
}

API TikTok Shop

Gerez les paramètres d'intégration, synchronisez vos produits conformément aux normes GPSR de l'UE et récupérez les commandes TikTok Shop.

GET/api/seller/tiktok/config
Nécessite l'en-tête Authorization: Bearer sk_mkt_...

Renvoie le statut de la connexion, le nom de la boutique, la région et les correspondances GPSR et entrepôts par défaut.

POST/api/seller/tiktok/config
Nécessite l'en-tête Authorization: Bearer sk_mkt_...

Enregistre ou met à jour les paramètres de connexion à TikTok Shop, les modèles d'expédition et les identifiants GPSR.

{
  "region": "PL",
  "default_category_id": "602123",
  "default_warehouse_id": "123456789",
  "default_gpsr_manufacturer_id": "mfg_uuid",
  "default_gpsr_responsible_person_id": "rp_uuid",
  "auto_upload_products": true,
  "sync_inventory_realtime": true
}
GET/api/seller/tiktok/warehouses
Nécessite l'en-tête Authorization: Bearer sk_mkt_...

Récupère la liste des entrepôts actifs de votre profil logistique TikTok Shop, requise pour la mise à jour des stocks.

POST/api/seller/tiktok/sync
Nécessite l'en-tête Authorization: Bearer sk_mkt_...

Déclenche la synchronisation immédiate des offres sur TikTok Shop. Vérifie le statut de l'EAN, télécharge les images, configure la conformité GPSR de l'UE, ou met à jour les prix/stocks.

Liste des EAN à synchroniser (facultatif, un tableau vide synchronise tout).

{
  "eans": ["5901234123457", "5901234123464"]
}

Réponse

{
  "success": true,
  "synced_count": 2,
  "created": 1,
  "updated": 1,
  "message": "TikTok EU Sync: 1 created, 1 updated."
}
GET/api/seller/tiktok/orders
Nécessite l'en-tête Authorization: Bearer sk_mkt_...

Récupère les commandes TikTok Shop mises en cache. Utilisez ?refresh=1 pour forcer la mise à jour en direct depuis l'API TikTok.

Foire Aux Questions (FAQ)

Quelle méthode d'authentification utilise l'API Scopio ?

Clé API Bearer. Générez votre clé sk_mkt_... dans votre compte B2B. Ajoutez l'en-tête : Authorization: Bearer sk_mkt_...

Quels champs de produits sont requis pour la synchronisation ?

Minimum : ean (chaîne), price (nombre), qty (entier). Exemple: [{"ean":"5901234123457","price":29.99,"qty":10}]

L'API Scopio prend-elle en charge l'UCP (Universal Commerce Protocol) ?

Oui. Scopio est la première plateforme en Europe à implémenter le standard UCP, ce qui permet aux agents IA d'obtenir dynamiquement des offres et de finaliser des achats.

Comment fonctionne l'intégration TikTok Shop ?

Elle est entièrement automatisée. Vous connectez votre boutique via OAuth, définissez vos valeurs par défaut (expédition, catégories, entrepôt, profils GPSR) et appelez POST /api/seller/tiktok/sync pour les EAN. Scopio fait le reste.

Les agents IA peuvent-ils réserver des réunions dans le calendrier ?

Oui. L'appel GET /api/calendar/slots renvoie les créneaux libres, et POST /api/calendar/book valide la réservation.

Comment suivre les requêtes des robots IA ?

La requête GET /api/seller/analytics renvoie les statistiques sur 30 jours ventilées par modèle LLM (Claude, ChatGPT, Gemini, etc.), également visibles sur votre tableau de bord.

Prêt à vous intégrer?

L'API complète est en ligne.
Commencez en 5 minutes

Générez votre clé API, choisissez votre méthode d'intégration et envoyez votre premier produit. Réponse instantanée.