Idovio Commerce / Développeurs

Référence de l'API et des intégrations d'Idovio Commerce

Comment Idovio Commerce authentifie, quels points d'accès il expose, comment il se connecte aux canaux de vente et aux fournisseurs, et quelles données traite chaque connexion. Les tableaux de points d'accès sont générés à partir du code source du produit.

Ce qui est disponible aujourd'hui

En service
Relais de connexion sur connect.idovio.com : retours OAuth et notifications de confidentialité exigées par Shopify et eBay.
En service
Application web sur idovio.app.
Pas encore public
API de compte et d'espace de travail : développée et couverte par des tests automatisés, mais pas encore publiée à une adresse publique. La référence ci-dessous décrit la version du code source.
Pas encore public
Aucune clé d'API n'est encore délivrée aux applications tierces. Leurs droits et limites seront documentés ici le moment venu.

Authentification

Les personnes se connectent avec un compte Idovio : e-mail et mot de passe, ou Google. Les actions sensibles exigent un second facteur (TOTP).
Sur le web, la session voyage dans un cookie HttpOnly. Toute requête qui modifie quelque chose doit envoyer le jeton CSRF dans l'en-tête X-Idovio-CSRF et provenir d'une origine autorisée.
Les applications de bureau et mobiles reçoivent le jeton de session une seule fois et l'envoient en Authorization: Bearer.
Chaque requête d'un espace de travail est vérifiée selon l'appartenance et le rôle de la personne connectée ; les données d'un espace ne sont jamais renvoyées à un autre.

Relais de connexion

Les fournisseurs renvoient le marchand vers ces adresses après son consentement et y livrent leurs notifications de confidentialité obligatoires. Le relais ne conserve rien : il échange l'autorisation contre les jetons et les remet à l'espace de travail du marchand.

Méthode	Chemin
`GET`	`https://connect.idovio.com/health`	État du service et fournisseurs configurés
`GET`	`https://connect.idovio.com/oauth/callback/{provider}`	Adresse de retour à déclarer dans la console développeur du fournisseur
`POST`	`https://connect.idovio.com/webhooks/shopify/customers-data-request`	Notification de confidentialité obligatoire de Shopify, signature HMAC vérifiée
`POST`	`https://connect.idovio.com/webhooks/shopify/customers-redact`	Notification de confidentialité obligatoire de Shopify, signature HMAC vérifiée
`POST`	`https://connect.idovio.com/webhooks/shopify/shop-redact`	Notification de confidentialité obligatoire de Shopify, signature HMAC vérifiée
`GET`	`https://connect.idovio.com/webhooks/ebay/account-deletion`	Vérification de propriété du point d'accès par eBay
`POST`	`https://connect.idovio.com/webhooks/ebay/account-deletion`	Notification de suppression de compte eBay

Points d'accès REST

Tous les chemins sont relatifs à l'origine de l'API. Requêtes et réponses en JSON.

Connexion et sécurité

Méthode	Chemin	Accès
`GET`	`/api/v1/auth/auth0/callback`	Public
`GET`	`/api/v1/auth/auth0/logout`	Public
`GET`	`/api/v1/auth/auth0/start`	Public
`GET`	`/api/v1/auth/google/callback`	Public
`GET`	`/api/v1/auth/google/start`	Public
`POST`	`/api/v1/auth/handoff`	Public
`POST`	`/api/v1/auth/login`	Public
`POST`	`/api/v1/auth/logout`	Utilisateur connecté
`GET`	`/api/v1/auth/mfa`	Utilisateur connecté
`POST`	`/api/v1/auth/mfa/disable`	Utilisateur connecté
`POST`	`/api/v1/auth/mfa/enroll`	Utilisateur connecté
`POST`	`/api/v1/auth/mfa/enroll/confirm`	Utilisateur connecté
`POST`	`/api/v1/auth/mfa/login`	Public
`POST`	`/api/v1/auth/mfa/recovery-codes`	Utilisateur connecté
`POST`	`/api/v1/auth/mfa/verify`	Utilisateur connecté
`POST`	`/api/v1/auth/password/change`	Utilisateur connecté
`POST`	`/api/v1/auth/password/forgot`	Public
`POST`	`/api/v1/auth/password/reset`	Public
`GET`	`/api/v1/auth/providers`	Public
`GET`	`/api/v1/auth/session`	Utilisateur connecté
`POST`	`/api/v1/auth/signup`	Public
`POST`	`/api/v1/auth/verify-email`	Public
`POST`	`/api/v1/auth/verify-email/resend`	Utilisateur connecté

Compte et appareils

Méthode	Chemin	Accès
`GET`	`/api/v1/account`	Utilisateur connecté
`PATCH`	`/api/v1/account`	Utilisateur connecté
`GET`	`/api/v1/devices`	Utilisateur connecté
`DELETE`	`/api/v1/devices/:id`	Utilisateur connecté
`POST`	`/api/v1/devices/revoke-others`	Utilisateur connecté
`POST`	`/api/v1/invitations/accept`	Utilisateur connecté

Espace de travail et équipe

Méthode	Chemin	Accès
`GET`	`/api/v1/audit`	Membre de l'espace
`GET`	`/api/v1/members`	Membre de l'espace
`PATCH`	`/api/v1/members/:userId`	Membre de l'espace
`DELETE`	`/api/v1/members/:userId`	Membre de l'espace
`POST`	`/api/v1/members/invitations`	Membre de l'espace
`DELETE`	`/api/v1/members/invitations/:id`	Membre de l'espace
`GET`	`/api/v1/usage`	Membre de l'espace
`GET`	`/api/v1/workspace`	Membre de l'espace
`PATCH`	`/api/v1/workspace`	Membre de l'espace
`GET`	`/api/v1/workspace/data`	Membre de l'espace
`POST`	`/api/v1/workspace/data`	Membre de l'espace
`GET`	`/api/v1/workspace/layout`	Membre de l'espace
`PATCH`	`/api/v1/workspace/layout`	Membre de l'espace
`POST`	`/api/v1/workspace/members/:userId/mfa/reset`	Membre de l'espace
`GET`	`/api/v1/workspaces`	Utilisateur connecté
`POST`	`/api/v1/workspaces`	Utilisateur connecté
`POST`	`/api/v1/workspaces/:id/select`	Utilisateur connecté

Catalogue, commandes et tâches

Méthode	Chemin	Accès
`GET`	`/api/v1/commerce/orders`	Membre de l'espace
`GET`	`/api/v1/commerce/products`	Membre de l'espace
`GET`	`/api/v1/jobs`	Membre de l'espace
`POST`	`/api/v1/jobs/:id/cancel`	Membre de l'espace
`POST`	`/api/v1/jobs/:id/retry`	Membre de l'espace

Connexions et identifiants

Méthode	Chemin	Accès
`POST`	`/api/v1/amazon/connect`	Membre de l'espace
`GET`	`/api/v1/amazon/connections`	Membre de l'espace
`DELETE`	`/api/v1/amazon/connections/:id`	Membre de l'espace
`POST`	`/api/v1/amazon/connections/:id/call`	Membre de l'espace
`GET`	`/api/v1/amazon/connections/:id/finances`	Membre de l'espace
`GET`	`/api/v1/amazon/connections/:id/inventory`	Membre de l'espace
`GET`	`/api/v1/amazon/connections/:id/orders`	Membre de l'espace
`GET`	`/api/v1/amazon/oauth/callback`	Membre de l'espace
`GET`	`/api/v1/amazon/oauth/login`	Public
`GET`	`/api/v1/amazon/oauth/start`	Membre de l'espace
`POST`	`/api/v1/connectors/oauth/:provider/start`	Membre de l'espace
`GET`	`/api/v1/connectors/oauth/callback/:provider`	Membre de l'espace
`GET`	`/api/v1/connectors/oauth/connections`	Membre de l'espace
`DELETE`	`/api/v1/connectors/oauth/connections/:id`	Membre de l'espace
`POST`	`/api/v1/connectors/oauth/connections/:id/read`	Membre de l'espace
`GET`	`/api/v1/connectors/oauth/providers`	Membre de l'espace
`GET`	`/api/v1/connectors/vault/:name`	Membre de l'espace
`PUT`	`/api/v1/connectors/vault/:name`	Membre de l'espace
`DELETE`	`/api/v1/connectors/vault/:name`	Membre de l'espace
`POST`	`/api/v1/connectors/vault/call`	Membre de l'espace
`GET`	`/api/v1/secrets`	Membre de l'espace
`PUT`	`/api/v1/secrets/:name`	Membre de l'espace
`DELETE`	`/api/v1/secrets/:name`	Membre de l'espace
`POST`	`/api/v1/secrets/rotate-key`	Membre de l'espace

Automatisation et approbations

Méthode	Chemin	Accès
`GET`	`/api/v1/automation/approvals`	Membre de l'espace
`POST`	`/api/v1/automation/approvals/:id/approve`	Membre de l'espace
`POST`	`/api/v1/automation/approvals/:id/reject`	Membre de l'espace
`GET`	`/api/v1/automation/executions/:id`	Membre de l'espace
`POST`	`/api/v1/automation/executions/:id/cancel`	Membre de l'espace
`GET`	`/api/v1/automation/executions/:id/events`	Membre de l'espace
`POST`	`/api/v1/automation/executions/:id/retry`	Membre de l'espace
`GET`	`/api/v1/automation/skills`	Membre de l'espace
`POST`	`/api/v1/automation/skills/:skill/execute`	Membre de l'espace

Offres et facturation

Méthode	Chemin	Accès
`GET`	`/api/v1/billing`	Membre de l'espace
`POST`	`/api/v1/billing/cancel`	Membre de l'espace
`POST`	`/api/v1/billing/change-plan`	Membre de l'espace
`POST`	`/api/v1/billing/checkout`	Membre de l'espace
`POST`	`/api/v1/billing/portal`	Membre de l'espace
`POST`	`/api/v1/billing/resume`	Membre de l'espace
`POST`	`/api/v1/billing/webhooks/stripe`	Public
`POST`	`/api/v1/entitlement/certificate`	Membre de l'espace
`GET`	`/api/v1/plans`	Public

État du service

Méthode	Chemin	Accès
`GET`	`/api/v1/client/release`	Public
`GET`	`/health`	Public
`GET`	`/ready`	Public
`GET`	`/runtime/health`	Public
`GET`	`/runtime/version`	Public
`GET`	`/version`	Public

Outils pour agents externes

Un assistant externe agit par le même plan de contrôle qu'une personne. Un identifiant le reconnaît, mais chaque appel passe tout de même par l'espace de travail, le droit, la politique, les limites et, si nécessaire, l'approbation humaine, puis est consigné.

commerce.get_overview
catalog.search
supplier.rank_routes
orders.search
ui.navigate
supplier.reroute
price.update
automation.run

Intégrations

Pour chaque connexion : comment le marchand l'autorise, ce qu'Idovio Commerce peut faire à travers elle, quelles catégories de données elle traite et comment arrivent les changements. La disponibilité actuelle figure sur la page Connexions. Connexions

Fournisseur	Autorisation	Capacités	Données traitées	Mises à jour
AliExpress	OAuth via l'application Idovio	`catalog.importcatalog.readcatalog.searchorder.createprice.readshipping.quotestock.readtracking.read`	`CredentialConfidentialPersonal Data`	À la demande
Amazon	OAuth via l'application Idovio	`account.discovercatalog.publishcatalog.readcatalog.searchcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write`	`CredentialSensitive Platform DataRestricted Platform Data`	Interrogation périodique
BigBuy	Clé d'API du marchand	`catalog.readcatalog.searchorder.createprice.readstock.read`	`CredentialConfidentialPersonal Data`	À la demande
Bookvault	Clé d'API du marchand	`catalog.readcatalog.searchprice.readshipping.quotetracking.read`	`CredentialConfidential`	Interrogation périodique
CJ Dropshipping	Clé d'API du marchand	`catalog.readcatalog.searchorder.createprice.readstock.readtracking.read`	`CredentialConfidentialPersonal Data`	Point de réception de notifications
Cloudprinter	Clé d'API du marchand	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
EasyPost	Clé d'API du marchand	`shipping.label.createshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
eBay	OAuth via l'application Idovio	`account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writerefund.writereturn.readstock.readstock.writetracking.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogation périodique
Etsy	OAuth avec PKCE	`account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write`	`CredentialPersonal DataSensitive Platform Data`	À la demande
Gelato	Clé d'API du marchand	`catalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
Gmail	OAuth via l'application Idovio	`account.discovermail.read`	`CredentialPersonal DataRestricted Platform Data`	Interrogation périodique
Google Ads	OAuth via l'application Idovio	`ads.budgetads.pauseads.read`	`CredentialSensitive Platform Data`	À la demande
Gooten	Clé d'API du marchand	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
Lemon Squeezy	Identifiants d'application du marchand	`order.read`	`CredentialPersonal DataSensitive Platform Data`	Interrogation périodique
Lulu Direct	Clé d'API du marchand	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
Meta Ads	OAuth via l'application Idovio	`ads.budgetads.pauseads.read`	`CredentialSensitive Platform Data`	À la demande
Microsoft Outlook	OAuth via l'application Idovio	`account.discovermail.read`	`CredentialPersonal Data`	Interrogation périodique
Ollama	Local, sans compte externe	`model.managemodel.run`	`InternalConfidential`	À la demande
Own Warehouse	Local, sans compte externe	`catalog.readcatalog.searchorder.createprice.readreturn.requeststock.read`	`InternalConfidential`	À la demande
Paddle	Identifiants d'application du marchand	`order.read`	`CredentialPersonal DataSensitive Platform Data`	Interrogation périodique
Printful	OAuth via l'application Idovio	`catalog.importcatalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotestock.readtracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
Printify	OAuth via l'application Idovio	`catalog.importcatalog.readcatalog.searchorder.cancelorder.createprice.readrefund.requestreturn.requestshipping.quotestock.readtracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
Prodigi	Clé d'API du marchand	`catalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
Shirtigo	Clé d'API du marchand	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogation périodique
Shopify	Identifiants d'application du marchand	`catalog.publishcatalog.readcatalog.updatelisting.pauseorder.readprice.readprice.writestock.readstock.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogation périodique
Stripe	Identifiants d'application du marchand	`order.readrefund.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogation périodique
TikTok Ads	OAuth via l'application Idovio	`ads.budgetads.pauseads.read`	`CredentialSensitive Platform Data`	À la demande
TikTok Shop	OAuth via l'application Idovio	`account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writereturn.readstock.readstock.writetracking.writewebhook.verify`	`CredentialPersonal DataSensitive Platform Data`	Point de réception de notifications
Universal IMAP	Identifiants d'application du marchand	`mail.read`	`CredentialPersonal Data`	Interrogation périodique
Wix	Identifiants d'application du marchand	`catalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogation périodique
WooCommerce	Identifiants d'application du marchand	`catalog.publishcatalog.readcatalog.updatelisting.pauseorder.readprice.readprice.writerefund.writestock.readstock.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogation périodique

Conventions

Les erreurs sont en JSON, avec un code stable et un message lisible. Une réponse 429 contient Retry-After.
Chaque réponse contient X-Request-Id. Envoyez votre propre valeur dans cet en-tête pour suivre une requête de bout en bout.
Les opérations qui modifient les stocks, les prix ou les commandes utilisent une clé d'idempotence : répéter la requête ne répète jamais son effet.

Protection des données

Les identifiants de connexion sont chiffrés par espace de travail avant d'être enregistrés et l'API ne les renvoie jamais.
Le marchand peut déconnecter un fournisseur à tout moment ; l'autorisation enregistrée est supprimée.
Les demandes de suppression envoyées par les fournisseurs sont confirmées et appliquées à l'espace de travail concerné.

Politique de confidentialité Conditions SécuritéContact technique: idev@idovio.com