Idovio Commerce / Sviluppatori

Riferimento dell'API e delle integrazioni di Idovio Commerce

Come Idovio Commerce autentica, quali punti di accesso espone, come si collega a canali di vendita e fornitori e quali dati tratta ogni connessione. Le tabelle dei punti di accesso sono generate dal codice sorgente del prodotto.

Che cosa è disponibile oggi

In servizio
Intermediario delle connessioni su connect.idovio.com: ritorni OAuth e gli avvisi sulla riservatezza richiesti da Shopify ed eBay.
In servizio
Applicazione web su idovio.app.
Non ancora pubblico
API di account e spazio di lavoro: realizzata e coperta da test automatici, ma non ancora pubblicata a un indirizzo pubblico. Il riferimento qui sotto descrive la versione del codice sorgente.
Non ancora pubblico
Non vengono ancora rilasciate chiavi API per applicazioni di terzi. Permessi e limiti saranno documentati qui quando lo saranno.

Autenticazione

Le persone accedono con un account Idovio: e-mail e password, oppure Google. Le azioni sensibili richiedono un secondo fattore (TOTP).
Sul web la sessione viaggia in un cookie HttpOnly. Ogni richiesta che modifica qualcosa deve inviare il token CSRF nell'intestazione X-Idovio-CSRF e provenire da un'origine consentita.
Le applicazioni desktop e mobili ricevono il token di sessione una sola volta e lo inviano come Authorization: Bearer.
Ogni richiesta a uno spazio di lavoro è verificata rispetto all'appartenenza e al ruolo di chi ha effettuato l'accesso; i dati di uno spazio non vengono mai restituiti a un altro.

Intermediario delle connessioni

I fornitori rimandano il commerciante a questi indirizzi dopo il consenso e vi consegnano gli avvisi obbligatori sulla riservatezza. L'intermediario non conserva nulla: scambia l'autorizzazione con i token e li consegna allo spazio di lavoro del commerciante.

Metodo	Percorso
`GET`	`https://connect.idovio.com/health`	Stato del servizio e fornitori configurati
`GET`	`https://connect.idovio.com/oauth/callback/{provider}`	Indirizzo di ritorno da registrare nella console sviluppatori del fornitore
`POST`	`https://connect.idovio.com/webhooks/shopify/customers-data-request`	Avviso obbligatorio sulla riservatezza di Shopify, firma HMAC verificata
`POST`	`https://connect.idovio.com/webhooks/shopify/customers-redact`	Avviso obbligatorio sulla riservatezza di Shopify, firma HMAC verificata
`POST`	`https://connect.idovio.com/webhooks/shopify/shop-redact`	Avviso obbligatorio sulla riservatezza di Shopify, firma HMAC verificata
`GET`	`https://connect.idovio.com/webhooks/ebay/account-deletion`	Verifica di titolarità del punto di accesso da parte di eBay
`POST`	`https://connect.idovio.com/webhooks/ebay/account-deletion`	Avviso di eliminazione dell'account eBay

Punti di accesso REST

Tutti i percorsi sono relativi all'origine dell'API. Richieste e risposte in JSON.

Accesso e sicurezza

Metodo	Percorso	Accesso
`GET`	`/api/v1/auth/auth0/callback`	Pubblico
`GET`	`/api/v1/auth/auth0/logout`	Pubblico
`GET`	`/api/v1/auth/auth0/start`	Pubblico
`GET`	`/api/v1/auth/google/callback`	Pubblico
`GET`	`/api/v1/auth/google/start`	Pubblico
`POST`	`/api/v1/auth/handoff`	Pubblico
`POST`	`/api/v1/auth/login`	Pubblico
`POST`	`/api/v1/auth/logout`	Utente autenticato
`GET`	`/api/v1/auth/mfa`	Utente autenticato
`POST`	`/api/v1/auth/mfa/disable`	Utente autenticato
`POST`	`/api/v1/auth/mfa/enroll`	Utente autenticato
`POST`	`/api/v1/auth/mfa/enroll/confirm`	Utente autenticato
`POST`	`/api/v1/auth/mfa/login`	Pubblico
`POST`	`/api/v1/auth/mfa/recovery-codes`	Utente autenticato
`POST`	`/api/v1/auth/mfa/verify`	Utente autenticato
`POST`	`/api/v1/auth/password/change`	Utente autenticato
`POST`	`/api/v1/auth/password/forgot`	Pubblico
`POST`	`/api/v1/auth/password/reset`	Pubblico
`GET`	`/api/v1/auth/providers`	Pubblico
`GET`	`/api/v1/auth/session`	Utente autenticato
`POST`	`/api/v1/auth/signup`	Pubblico
`POST`	`/api/v1/auth/verify-email`	Pubblico
`POST`	`/api/v1/auth/verify-email/resend`	Utente autenticato

Account e dispositivi

Metodo	Percorso	Accesso
`GET`	`/api/v1/account`	Utente autenticato
`PATCH`	`/api/v1/account`	Utente autenticato
`GET`	`/api/v1/devices`	Utente autenticato
`DELETE`	`/api/v1/devices/:id`	Utente autenticato
`POST`	`/api/v1/devices/revoke-others`	Utente autenticato
`POST`	`/api/v1/invitations/accept`	Utente autenticato

Spazio di lavoro e squadra

Metodo	Percorso	Accesso
`GET`	`/api/v1/audit`	Membro dello spazio
`GET`	`/api/v1/members`	Membro dello spazio
`PATCH`	`/api/v1/members/:userId`	Membro dello spazio
`DELETE`	`/api/v1/members/:userId`	Membro dello spazio
`POST`	`/api/v1/members/invitations`	Membro dello spazio
`DELETE`	`/api/v1/members/invitations/:id`	Membro dello spazio
`GET`	`/api/v1/usage`	Membro dello spazio
`GET`	`/api/v1/workspace`	Membro dello spazio
`PATCH`	`/api/v1/workspace`	Membro dello spazio
`GET`	`/api/v1/workspace/data`	Membro dello spazio
`POST`	`/api/v1/workspace/data`	Membro dello spazio
`GET`	`/api/v1/workspace/layout`	Membro dello spazio
`PATCH`	`/api/v1/workspace/layout`	Membro dello spazio
`POST`	`/api/v1/workspace/members/:userId/mfa/reset`	Membro dello spazio
`GET`	`/api/v1/workspaces`	Utente autenticato
`POST`	`/api/v1/workspaces`	Utente autenticato
`POST`	`/api/v1/workspaces/:id/select`	Utente autenticato

Catalogo, ordini e attività

Metodo	Percorso	Accesso
`GET`	`/api/v1/commerce/orders`	Membro dello spazio
`GET`	`/api/v1/commerce/products`	Membro dello spazio
`GET`	`/api/v1/jobs`	Membro dello spazio
`POST`	`/api/v1/jobs/:id/cancel`	Membro dello spazio
`POST`	`/api/v1/jobs/:id/retry`	Membro dello spazio

Connessioni e credenziali

Metodo	Percorso	Accesso
`POST`	`/api/v1/amazon/connect`	Membro dello spazio
`GET`	`/api/v1/amazon/connections`	Membro dello spazio
`DELETE`	`/api/v1/amazon/connections/:id`	Membro dello spazio
`POST`	`/api/v1/amazon/connections/:id/call`	Membro dello spazio
`GET`	`/api/v1/amazon/connections/:id/finances`	Membro dello spazio
`GET`	`/api/v1/amazon/connections/:id/inventory`	Membro dello spazio
`GET`	`/api/v1/amazon/connections/:id/orders`	Membro dello spazio
`GET`	`/api/v1/amazon/oauth/callback`	Membro dello spazio
`GET`	`/api/v1/amazon/oauth/login`	Pubblico
`GET`	`/api/v1/amazon/oauth/start`	Membro dello spazio
`POST`	`/api/v1/connectors/oauth/:provider/start`	Membro dello spazio
`GET`	`/api/v1/connectors/oauth/callback/:provider`	Membro dello spazio
`GET`	`/api/v1/connectors/oauth/connections`	Membro dello spazio
`DELETE`	`/api/v1/connectors/oauth/connections/:id`	Membro dello spazio
`POST`	`/api/v1/connectors/oauth/connections/:id/read`	Membro dello spazio
`GET`	`/api/v1/connectors/oauth/providers`	Membro dello spazio
`GET`	`/api/v1/connectors/vault/:name`	Membro dello spazio
`PUT`	`/api/v1/connectors/vault/:name`	Membro dello spazio
`DELETE`	`/api/v1/connectors/vault/:name`	Membro dello spazio
`POST`	`/api/v1/connectors/vault/call`	Membro dello spazio
`GET`	`/api/v1/secrets`	Membro dello spazio
`PUT`	`/api/v1/secrets/:name`	Membro dello spazio
`DELETE`	`/api/v1/secrets/:name`	Membro dello spazio
`POST`	`/api/v1/secrets/rotate-key`	Membro dello spazio

Automazione e approvazioni

Metodo	Percorso	Accesso
`GET`	`/api/v1/automation/approvals`	Membro dello spazio
`POST`	`/api/v1/automation/approvals/:id/approve`	Membro dello spazio
`POST`	`/api/v1/automation/approvals/:id/reject`	Membro dello spazio
`GET`	`/api/v1/automation/executions/:id`	Membro dello spazio
`POST`	`/api/v1/automation/executions/:id/cancel`	Membro dello spazio
`GET`	`/api/v1/automation/executions/:id/events`	Membro dello spazio
`POST`	`/api/v1/automation/executions/:id/retry`	Membro dello spazio
`GET`	`/api/v1/automation/skills`	Membro dello spazio
`POST`	`/api/v1/automation/skills/:skill/execute`	Membro dello spazio

Piani e fatturazione

Metodo	Percorso	Accesso
`GET`	`/api/v1/billing`	Membro dello spazio
`POST`	`/api/v1/billing/cancel`	Membro dello spazio
`POST`	`/api/v1/billing/change-plan`	Membro dello spazio
`POST`	`/api/v1/billing/checkout`	Membro dello spazio
`POST`	`/api/v1/billing/portal`	Membro dello spazio
`POST`	`/api/v1/billing/resume`	Membro dello spazio
`POST`	`/api/v1/billing/webhooks/stripe`	Pubblico
`POST`	`/api/v1/entitlement/certificate`	Membro dello spazio
`GET`	`/api/v1/plans`	Pubblico

Stato del servizio

Metodo	Percorso	Accesso
`GET`	`/api/v1/client/release`	Pubblico
`GET`	`/health`	Pubblico
`GET`	`/ready`	Pubblico
`GET`	`/runtime/health`	Pubblico
`GET`	`/runtime/version`	Pubblico
`GET`	`/version`	Pubblico

Strumenti per agenti esterni

Un assistente esterno agisce attraverso lo stesso piano di controllo di una persona. Una credenziale lo identifica, ma ogni chiamata passa comunque per spazio di lavoro, permesso, politica, limiti e, dove serve, approvazione umana, e viene registrata.

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

Integrazioni

Per ogni connessione: come la autorizza il commerciante, che cosa può fare Idovio Commerce attraverso di essa, quali classi di dati tratta e come arrivano le modifiche. La disponibilità attuale è nella pagina Connessioni. Connessioni

Fornitore	Autorizzazione	Capacità	Dati trattati	Aggiornamenti
AliExpress	OAuth tramite l'applicazione Idovio	`catalog.importcatalog.readcatalog.searchorder.createprice.readshipping.quotestock.readtracking.read`	`CredentialConfidentialPersonal Data`	Su richiesta
Amazon	OAuth tramite l'applicazione Idovio	`account.discovercatalog.publishcatalog.readcatalog.searchcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write`	`CredentialSensitive Platform DataRestricted Platform Data`	Interrogazione periodica
BigBuy	Chiave API del commerciante	`catalog.readcatalog.searchorder.createprice.readstock.read`	`CredentialConfidentialPersonal Data`	Su richiesta
Bookvault	Chiave API del commerciante	`catalog.readcatalog.searchprice.readshipping.quotetracking.read`	`CredentialConfidential`	Interrogazione periodica
CJ Dropshipping	Chiave API del commerciante	`catalog.readcatalog.searchorder.createprice.readstock.readtracking.read`	`CredentialConfidentialPersonal Data`	Punto di ricezione degli avvisi
Cloudprinter	Chiave API del commerciante	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
EasyPost	Chiave API del commerciante	`shipping.label.createshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
eBay	OAuth tramite l'applicazione Idovio	`account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writerefund.writereturn.readstock.readstock.writetracking.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogazione periodica
Etsy	OAuth con PKCE	`account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write`	`CredentialPersonal DataSensitive Platform Data`	Su richiesta
Gelato	Chiave API del commerciante	`catalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
Gmail	OAuth tramite l'applicazione Idovio	`account.discovermail.read`	`CredentialPersonal DataRestricted Platform Data`	Interrogazione periodica
Google Ads	OAuth tramite l'applicazione Idovio	`ads.budgetads.pauseads.read`	`CredentialSensitive Platform Data`	Su richiesta
Gooten	Chiave API del commerciante	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
Lemon Squeezy	Credenziali applicative del commerciante	`order.read`	`CredentialPersonal DataSensitive Platform Data`	Interrogazione periodica
Lulu Direct	Chiave API del commerciante	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
Meta Ads	OAuth tramite l'applicazione Idovio	`ads.budgetads.pauseads.read`	`CredentialSensitive Platform Data`	Su richiesta
Microsoft Outlook	OAuth tramite l'applicazione Idovio	`account.discovermail.read`	`CredentialPersonal Data`	Interrogazione periodica
Ollama	Locale, senza account esterno	`model.managemodel.run`	`InternalConfidential`	Su richiesta
Own Warehouse	Locale, senza account esterno	`catalog.readcatalog.searchorder.createprice.readreturn.requeststock.read`	`InternalConfidential`	Su richiesta
Paddle	Credenziali applicative del commerciante	`order.read`	`CredentialPersonal DataSensitive Platform Data`	Interrogazione periodica
Printful	OAuth tramite l'applicazione Idovio	`catalog.importcatalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotestock.readtracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
Printify	OAuth tramite l'applicazione Idovio	`catalog.importcatalog.readcatalog.searchorder.cancelorder.createprice.readrefund.requestreturn.requestshipping.quotestock.readtracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
Prodigi	Chiave API del commerciante	`catalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
Shirtigo	Chiave API del commerciante	`catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read`	`CredentialConfidentialPersonal Data`	Interrogazione periodica
Shopify	Credenziali applicative del commerciante	`catalog.publishcatalog.readcatalog.updatelisting.pauseorder.readprice.readprice.writestock.readstock.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogazione periodica
Stripe	Credenziali applicative del commerciante	`order.readrefund.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogazione periodica
TikTok Ads	OAuth tramite l'applicazione Idovio	`ads.budgetads.pauseads.read`	`CredentialSensitive Platform Data`	Su richiesta
TikTok Shop	OAuth tramite l'applicazione Idovio	`account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writereturn.readstock.readstock.writetracking.writewebhook.verify`	`CredentialPersonal DataSensitive Platform Data`	Punto di ricezione degli avvisi
Universal IMAP	Credenziali applicative del commerciante	`mail.read`	`CredentialPersonal Data`	Interrogazione periodica
Wix	Credenziali applicative del commerciante	`catalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogazione periodica
WooCommerce	Credenziali applicative del commerciante	`catalog.publishcatalog.readcatalog.updatelisting.pauseorder.readprice.readprice.writerefund.writestock.readstock.write`	`CredentialPersonal DataSensitive Platform Data`	Interrogazione periodica

Convenzioni

Gli errori sono JSON con un codice stabile e un messaggio leggibile. Una risposta 429 contiene Retry-After.
Ogni risposta contiene X-Request-Id. Inviate un vostro valore in quell'intestazione per seguire una richiesta dall'inizio alla fine.
Le operazioni che modificano scorte, prezzi o ordini usano una chiave di idempotenza: ripetere la richiesta non ne ripete mai l'effetto.

Protezione dei dati

Le credenziali di connessione sono cifrate per spazio di lavoro prima di essere salvate e l'API non le restituisce mai.
Il commerciante può scollegare un fornitore in qualsiasi momento; l'autorizzazione salvata viene rimossa.
Le richieste di eliminazione inviate dai fornitori vengono confermate e applicate allo spazio di lavoro interessato.

Informativa sulla privacy Condizioni SicurezzaContatto tecnico: idev@idovio.com