Idovio Commerce 如何进行身份验证、提供哪些接口、如何连接销售渠道与供应商，以及每个连接处理哪些数据。接口表格由产品源代码生成。
连接中介 connect.idovio.com：处理 OAuth 回调，以及 Shopify 和 eBay 要求的隐私通知。
网页应用 idovio.app。
账户与工作区接口：已开发并有自动化测试覆盖，但尚未在公开地址发布。下方参考描述的是源代码中的版本。
目前尚未向第三方应用发放接口密钥。发放后，其权限范围与限制将在此说明。
服务方在商家同意后将其带回这些地址，并在此发送必须处理的隐私通知。中介不保存任何内容：它用授权换取令牌，并交给商家自己的工作区。
| 方法 | 路径 | |
|---|---|---|
GET | https://connect.idovio.com/health | 服务状态与已配置的服务方 |
GET | https://connect.idovio.com/oauth/callback/{provider} | 需在服务方开发者后台登记的回调地址 |
POST | https://connect.idovio.com/webhooks/shopify/customers-data-request | Shopify 强制隐私通知，已校验 HMAC 签名 |
POST | https://connect.idovio.com/webhooks/shopify/customers-redact | Shopify 强制隐私通知，已校验 HMAC 签名 |
POST | https://connect.idovio.com/webhooks/shopify/shop-redact | Shopify 强制隐私通知，已校验 HMAC 签名 |
GET | https://connect.idovio.com/webhooks/ebay/account-deletion | eBay 对接口归属的验证 |
POST | https://connect.idovio.com/webhooks/ebay/account-deletion | eBay 账户删除通知 |
所有路径均相对于接口地址。请求与响应均为 JSON。
| 方法 | 路径 | 访问权限 |
|---|---|---|
GET | /api/v1/auth/auth0/callback | 公开 |
GET | /api/v1/auth/auth0/logout | 公开 |
GET | /api/v1/auth/auth0/start | 公开 |
GET | /api/v1/auth/google/callback | 公开 |
GET | /api/v1/auth/google/start | 公开 |
POST | /api/v1/auth/handoff | 公开 |
POST | /api/v1/auth/login | 公开 |
POST | /api/v1/auth/logout | 已登录用户 |
GET | /api/v1/auth/mfa | 已登录用户 |
POST | /api/v1/auth/mfa/disable | 已登录用户 |
POST | /api/v1/auth/mfa/enroll | 已登录用户 |
POST | /api/v1/auth/mfa/enroll/confirm | 已登录用户 |
POST | /api/v1/auth/mfa/login | 公开 |
POST | /api/v1/auth/mfa/recovery-codes | 已登录用户 |
POST | /api/v1/auth/mfa/verify | 已登录用户 |
POST | /api/v1/auth/password/change | 已登录用户 |
POST | /api/v1/auth/password/forgot | 公开 |
POST | /api/v1/auth/password/reset | 公开 |
GET | /api/v1/auth/providers | 公开 |
GET | /api/v1/auth/session | 已登录用户 |
POST | /api/v1/auth/signup | 公开 |
POST | /api/v1/auth/verify-email | 公开 |
POST | /api/v1/auth/verify-email/resend | 已登录用户 |
| 方法 | 路径 | 访问权限 |
|---|---|---|
GET | /api/v1/account | 已登录用户 |
PATCH | /api/v1/account | 已登录用户 |
GET | /api/v1/devices | 已登录用户 |
DELETE | /api/v1/devices/:id | 已登录用户 |
POST | /api/v1/devices/revoke-others | 已登录用户 |
POST | /api/v1/invitations/accept | 已登录用户 |
| 方法 | 路径 | 访问权限 |
|---|---|---|
GET | /api/v1/audit | 工作区成员 |
GET | /api/v1/members | 工作区成员 |
PATCH | /api/v1/members/:userId | 工作区成员 |
DELETE | /api/v1/members/:userId | 工作区成员 |
POST | /api/v1/members/invitations | 工作区成员 |
DELETE | /api/v1/members/invitations/:id | 工作区成员 |
GET | /api/v1/usage | 工作区成员 |
GET | /api/v1/workspace | 工作区成员 |
PATCH | /api/v1/workspace | 工作区成员 |
GET | /api/v1/workspace/data | 工作区成员 |
POST | /api/v1/workspace/data | 工作区成员 |
GET | /api/v1/workspace/layout | 工作区成员 |
PATCH | /api/v1/workspace/layout | 工作区成员 |
POST | /api/v1/workspace/members/:userId/mfa/reset | 工作区成员 |
GET | /api/v1/workspaces | 已登录用户 |
POST | /api/v1/workspaces | 已登录用户 |
POST | /api/v1/workspaces/:id/select | 已登录用户 |
| 方法 | 路径 | 访问权限 |
|---|---|---|
GET | /api/v1/commerce/orders | 工作区成员 |
GET | /api/v1/commerce/products | 工作区成员 |
GET | /api/v1/jobs | 工作区成员 |
POST | /api/v1/jobs/:id/cancel | 工作区成员 |
POST | /api/v1/jobs/:id/retry | 工作区成员 |
| 方法 | 路径 | 访问权限 |
|---|---|---|
POST | /api/v1/amazon/connect | 工作区成员 |
GET | /api/v1/amazon/connections | 工作区成员 |
DELETE | /api/v1/amazon/connections/:id | 工作区成员 |
POST | /api/v1/amazon/connections/:id/call | 工作区成员 |
GET | /api/v1/amazon/connections/:id/finances | 工作区成员 |
GET | /api/v1/amazon/connections/:id/inventory | 工作区成员 |
GET | /api/v1/amazon/connections/:id/orders | 工作区成员 |
GET | /api/v1/amazon/oauth/callback | 工作区成员 |
GET | /api/v1/amazon/oauth/login | 公开 |
GET | /api/v1/amazon/oauth/start | 工作区成员 |
POST | /api/v1/connectors/oauth/:provider/start | 工作区成员 |
GET | /api/v1/connectors/oauth/callback/:provider | 工作区成员 |
GET | /api/v1/connectors/oauth/connections | 工作区成员 |
DELETE | /api/v1/connectors/oauth/connections/:id | 工作区成员 |
POST | /api/v1/connectors/oauth/connections/:id/read | 工作区成员 |
GET | /api/v1/connectors/oauth/providers | 工作区成员 |
GET | /api/v1/connectors/vault/:name | 工作区成员 |
PUT | /api/v1/connectors/vault/:name | 工作区成员 |
DELETE | /api/v1/connectors/vault/:name | 工作区成员 |
POST | /api/v1/connectors/vault/call | 工作区成员 |
GET | /api/v1/secrets | 工作区成员 |
PUT | /api/v1/secrets/:name | 工作区成员 |
DELETE | /api/v1/secrets/:name | 工作区成员 |
POST | /api/v1/secrets/rotate-key | 工作区成员 |
| 方法 | 路径 | 访问权限 |
|---|---|---|
GET | /api/v1/automation/approvals | 工作区成员 |
POST | /api/v1/automation/approvals/:id/approve | 工作区成员 |
POST | /api/v1/automation/approvals/:id/reject | 工作区成员 |
GET | /api/v1/automation/executions/:id | 工作区成员 |
POST | /api/v1/automation/executions/:id/cancel | 工作区成员 |
GET | /api/v1/automation/executions/:id/events | 工作区成员 |
POST | /api/v1/automation/executions/:id/retry | 工作区成员 |
GET | /api/v1/automation/skills | 工作区成员 |
POST | /api/v1/automation/skills/:skill/execute | 工作区成员 |
| 方法 | 路径 | 访问权限 |
|---|---|---|
GET | /api/v1/billing | 工作区成员 |
POST | /api/v1/billing/cancel | 工作区成员 |
POST | /api/v1/billing/change-plan | 工作区成员 |
POST | /api/v1/billing/checkout | 工作区成员 |
POST | /api/v1/billing/portal | 工作区成员 |
POST | /api/v1/billing/resume | 工作区成员 |
POST | /api/v1/billing/webhooks/stripe | 公开 |
POST | /api/v1/entitlement/certificate | 工作区成员 |
GET | /api/v1/plans | 公开 |
| 方法 | 路径 | 访问权限 |
|---|---|---|
GET | /api/v1/client/release | 公开 |
GET | /health | 公开 |
GET | /ready | 公开 |
GET | /runtime/health | 公开 |
GET | /runtime/version | 公开 |
GET | /version | 公开 |
外部助手与真人使用同一个控制层。凭据只用于识别身份，每次调用仍须经过工作区、权限、策略、额度限制，必要时还需人工审批，并留有记录。
commerce.get_overviewcatalog.searchsupplier.rank_routesorders.searchui.navigatesupplier.rerouteprice.updateautomation.run针对每个连接：商家如何授权、Idovio Commerce 能通过它做什么、它处理哪些类别的数据，以及变更如何到达。当前可用情况见“连接”页面。 连接
| 服务方 | 授权方式 | 能力 | 处理的数据 | 更新方式 |
|---|---|---|---|---|
| AliExpress | 通过 Idovio 应用进行 OAuth | catalog.importcatalog.readcatalog.searchorder.createprice.readshipping.quotestock.readtracking.read | CredentialConfidentialPersonal Data | 按需 |
| Amazon | 通过 Idovio 应用进行 OAuth | account.discovercatalog.publishcatalog.readcatalog.searchcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write | CredentialSensitive Platform DataRestricted Platform Data | 定时轮询 |
| BigBuy | 商家自己的接口密钥 | catalog.readcatalog.searchorder.createprice.readstock.read | CredentialConfidentialPersonal Data | 按需 |
| Bookvault | 商家自己的接口密钥 | catalog.readcatalog.searchprice.readshipping.quotetracking.read | CredentialConfidential | 定时轮询 |
| CJ Dropshipping | 商家自己的接口密钥 | catalog.readcatalog.searchorder.createprice.readstock.readtracking.read | CredentialConfidentialPersonal Data | 通知接收地址 |
| Cloudprinter | 商家自己的接口密钥 | catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| EasyPost | 商家自己的接口密钥 | shipping.label.createshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| eBay | 通过 Idovio 应用进行 OAuth | account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writerefund.writereturn.readstock.readstock.writetracking.write | CredentialPersonal DataSensitive Platform Data | 定时轮询 |
| Etsy | 带 PKCE 的 OAuth | account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write | CredentialPersonal DataSensitive Platform Data | 按需 |
| Gelato | 商家自己的接口密钥 | catalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| Gmail | 通过 Idovio 应用进行 OAuth | account.discovermail.read | CredentialPersonal DataRestricted Platform Data | 定时轮询 |
| Google Ads | 通过 Idovio 应用进行 OAuth | ads.budgetads.pauseads.read | CredentialSensitive Platform Data | 按需 |
| Gooten | 商家自己的接口密钥 | catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| Lemon Squeezy | 商家自己的应用凭据 | order.read | CredentialPersonal DataSensitive Platform Data | 定时轮询 |
| Lulu Direct | 商家自己的接口密钥 | catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| Meta Ads | 通过 Idovio 应用进行 OAuth | ads.budgetads.pauseads.read | CredentialSensitive Platform Data | 按需 |
| Microsoft Outlook | 通过 Idovio 应用进行 OAuth | account.discovermail.read | CredentialPersonal Data | 定时轮询 |
| Ollama | 本地，无需外部账户 | model.managemodel.run | InternalConfidential | 按需 |
| Own Warehouse | 本地，无需外部账户 | catalog.readcatalog.searchorder.createprice.readreturn.requeststock.read | InternalConfidential | 按需 |
| Paddle | 商家自己的应用凭据 | order.read | CredentialPersonal DataSensitive Platform Data | 定时轮询 |
| Printful | 通过 Idovio 应用进行 OAuth | catalog.importcatalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotestock.readtracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| Printify | 通过 Idovio 应用进行 OAuth | catalog.importcatalog.readcatalog.searchorder.cancelorder.createprice.readrefund.requestreturn.requestshipping.quotestock.readtracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| Prodigi | 商家自己的接口密钥 | catalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| Shirtigo | 商家自己的接口密钥 | catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定时轮询 |
| Shopify | 商家自己的应用凭据 | catalog.publishcatalog.readcatalog.updatelisting.pauseorder.readprice.readprice.writestock.readstock.write | CredentialPersonal DataSensitive Platform Data | 定时轮询 |
| Stripe | 商家自己的应用凭据 | order.readrefund.write | CredentialPersonal DataSensitive Platform Data | 定时轮询 |
| TikTok Ads | 通过 Idovio 应用进行 OAuth | ads.budgetads.pauseads.read | CredentialSensitive Platform Data | 按需 |
| TikTok Shop | 通过 Idovio 应用进行 OAuth | account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writereturn.readstock.readstock.writetracking.writewebhook.verify | CredentialPersonal DataSensitive Platform Data | 通知接收地址 |
| Universal IMAP | 商家自己的应用凭据 | mail.read | CredentialPersonal Data | 定时轮询 |
| Wix | 商家自己的应用凭据 | catalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writestock.readstock.writetracking.write | CredentialPersonal DataSensitive Platform Data | 定时轮询 |
| WooCommerce | 商家自己的应用凭据 | catalog.publishcatalog.readcatalog.updatelisting.pauseorder.readprice.readprice.writerefund.writestock.readstock.write | CredentialPersonal DataSensitive Platform Data | 定时轮询 |
隐私政策条款安全技术联系: idev@idovio.com