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 automatique

"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
}

Serveur MCP polyvalent

Un point de terminaison distinct et plus large pour les agents IA — commerce, immobilier, voyage, réseaux sociaux et plus, en une seule connexion.

Point de terminaison

POST https://api.scopio.pl/mcp
GitHub ↗

Marketplace

Rechercher des produits, parcourir les catégories, panier, paiement.

Immobilier

Rechercher des annonces par lieu, prix et équipements.

Voyage

Vols, calendrier des prix et hôtels avec liens de réservation prêts.

Pharmacie

Vérifier la disponibilité et le stock des médicaments selon les emplacements.

Publication sur les réseaux sociaux

Générer des hashtags et légendes, publier et planifier des posts.

Contenu produit IA

Générer des photos, vidéos et essayage virtuel de produits.

Génération de leads

Trouver et enrichir des prospects, les mettre en file d'attente de prospection.

Agent intégrable

Un widget de chat IA personnalisable qui s'adapte à toute entreprise.

Synchronisation boutique

Connecter et synchroniser un catalogue de boutique en ligne existant.

Offres et abonnements

Parcourir et s'abonner à des offres directement depuis la conversation.

Contrairement au point de terminaison de synchronisation de produits ci-dessus — conçu spécifiquement pour importer votre propre catalogue dans Scopio — ce serveur polyvalent donne à tout agent IA un accès à l'ensemble de la plateforme : parcourir les catalogues, planifier des voyages, vérifier les stocks en pharmacie, gérer un pipeline complet de publication sur les réseaux sociaux, générer du contenu IA, et plus encore. Quelques outils sont gratuits et ouverts sans aucune authentification ; le reste s'active avec un abonnement Scopio, et l'agent guide l'utilisateur dans le choix d'une offre et l'obtention d'une clé sans quitter la conversation.

Essayez

Trouve-moi des boucles d'oreilles en argent à moins de 50 EUR livrées en Pologne
Génère des hashtags et une légende pour l'ouverture d'un nouveau café
Trouve les vols les moins chers de Varsovie à Barcelone le mois prochain
Trouve des cliniques dentaires à Cracovie et leurs coordonnées

Certains outils sont gratuits et ouverts à tout agent — sans compte. Les outils plus poussés nécessitent un abonnement actif.

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.

Quelle est la différence entre le MCP de synchronisation produits et le serveur MCP polyvalent ?

Le point de terminaison de synchronisation produits (POST /api/seller/products/mcp) est conçu de façon restreinte pour importer votre propre catalogue dans Scopio. Le serveur MCP polyvalent (POST https://api.scopio.pl/mcp) est un point de terminaison beaucoup plus large couvrant toute la plateforme — recherche marketplace, immobilier, voyage, pharmacie, publication sur les réseaux sociaux, génération de contenu IA, génération de leads et plus — utilisable par tout agent IA, pas seulement les vendeurs synchronisant leur inventaire.

Ai-je besoin d'une clé API pour utiliser le serveur MCP polyvalent ?

Pas pour tous les outils. Certains outils, comme la génération de hashtags et de légendes, sont gratuits et ouverts à tout agent sans authentification. Les outils plus poussés nécessitent un abonnement Scopio actif — appelez d'abord l'outil de catalogue pour voir les offres disponibles, puis abonnez-vous directement depuis la conversation.

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.