Développeurs

API publique SEEGEA

API REST en lecture sur le catalogue d'une boutique connectée à SEEGEA : produits, variantes, collections et commandes, dans un format identique quel que soit le CMS derrière (Shopify, PrestaShop).

Découverte

Spécification OpenAPI 3.1 : https://www.seegea.com/openapi.json
Métadonnées du serveur d'autorisation (RFC 8414) : /.well-known/oauth-authorization-server
Métadonnées de la ressource protégée (RFC 9728) : /.well-known/oauth-protected-resource
URL de base : https://www.seegea.com/api/v1

Obtenir une clé

L'accès API est inclus dans le plan Business. Depuis un compte Business, ouvrez Paramètres → API et cliquez sur « Créer une clé » : elle est générée immédiatement et affichée une seule fois. Aucun formulaire commercial, aucune validation manuelle.

Une clé a la forme sgk_<identifiant>.<secret> : la partie avant le point est le client_id OAuth, celle après le point le client_secret.

Voir les plans — l'API est réservée au plan Business ; les autres plans donnent accès à la grille et aux automatisations.

Portées

Portée	Description
`catalog:read`	Read products, variants, media and collections.
`orders:read`	Read imported orders (read-only mirror of the CMS orders).
`account:read`	Read the connected shop, its plan and its usage counters.

Authentification

Option 1 — clé API en Bearer

curl -H "Authorization: Bearer sgk_xxx.yyy" \
  https://www.seegea.com/api/v1/shop

Option 2 — OAuth 2.0 client_credentials

curl -X POST https://www.seegea.com/api/oauth/token \
  -u "sgk_xxx:yyy" \
  -d "grant_type=client_credentials" \
  -d "scope=catalog:read"

La réponse contient un access_token valable une heure, à envoyer ensuite en Bearer.

Une réponse 401 porte un en-tête WWW-Authenticate avec le paramètre resource_metadata (RFC 9728) : un agent y trouve seul les portées et le point de terminaison de jeton.

Points de terminaison

operationId	Méthode	Chemin	Portée
`getShop`	GET	/shop	`account:read`
`listProducts`	GET	/products	`catalog:read`
`getProduct`	GET	/products/{productId}	`catalog:read`
`listCollections`	GET	/collections	`catalog:read`
`listOrders`	GET	/orders	`orders:read`

Pagination

Les listes sont paginées par curseur. Suivez next_cursor tant que has_more vaut true.

curl -H "Authorization: Bearer sgk_xxx.yyy" \
  "https://www.seegea.com/api/v1/products?limit=100&cursor=eyJ0Ijoi..."

Limites de débit

120 requêtes par minute et par identifiant. Chaque réponse porte RateLimit-Limit et RateLimit-Remaining ; un 429 porte Retry-After.

Ligne de commande

Le CLI officiel enveloppe l'API pour les scripts et les agents :

npx @seegea/cli login
npx @seegea/cli shop
npx @seegea/cli products list --limit 50

Ce que l'API ne fait pas

Elle est en lecture seule : les écritures passent par la grille SEEGEA ou par les automatisations.
Elle n'expose pas les adresses e-mail des clients des commandes.
Elle ne renvoie ni les produits masqués par la limite du plan, ni les produits supprimés.

Pour les agents

/llms.txt — index du site
/agent-instructions.md — quand et comment appeler SEEGEA
/openapi.json — définitions pour le function calling