Idovio Commerce がどのように認証を行い、どのエンドポイントを提供し、販売チャネルや仕入先とどう接続し、各接続がどのデータを扱うかを説明します。エンドポイントの表は製品のソースコードから生成しています。
接続ブローカー connect.idovio.com：OAuth の戻り先と、Shopify および eBay が義務づけるプライバシー通知を受け付けます。
ウェブアプリ idovio.app。
アカウントとワークスペースの API：実装済みで自動テストの対象ですが、公開アドレスではまだ提供していません。以下のリファレンスはソースコード上の版を記述しています。
第三者アプリ向けの API キーはまだ発行していません。発行する際は、権限と制限をここに記載します。
各事業者は同意の後に販売者をこれらのアドレスへ戻し、義務づけられたプライバシー通知もここへ送ります。ブローカーは何も保存しません。認可をトークンに交換し、販売者自身のワークスペースへ渡します。
| メソッド | パス | |
|---|---|---|
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 アカウント削除の通知 |
パスはすべて API のオリジンからの相対パスです。リクエストとレスポンスは 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 | 販売者自身の API キー | catalog.readcatalog.searchorder.createprice.readstock.read | CredentialConfidentialPersonal Data | 要求時 |
| Bookvault | 販売者自身の API キー | catalog.readcatalog.searchprice.readshipping.quotetracking.read | CredentialConfidential | 定期的な取得 |
| CJ Dropshipping | 販売者自身の API キー | catalog.readcatalog.searchorder.createprice.readstock.readtracking.read | CredentialConfidentialPersonal Data | 通知の受信先 |
| Cloudprinter | 販売者自身の API キー | catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定期的な取得 |
| EasyPost | 販売者自身の API キー | 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 | 販売者自身の API キー | 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 | 販売者自身の API キー | catalog.readcatalog.searchorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定期的な取得 |
| Lemon Squeezy | 販売者自身のアプリ認証情報 | order.read | CredentialPersonal DataSensitive Platform Data | 定期的な取得 |
| Lulu Direct | 販売者自身の API キー | 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 | 販売者自身の API キー | catalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotetracking.read | CredentialConfidentialPersonal Data | 定期的な取得 |
| Shirtigo | 販売者自身の API キー | 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 | 定期的な取得 |