Как 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 | OAuth через приложение Idovio | catalog.importcatalog.readcatalog.searchorder.createprice.readshipping.quotestock.readtracking.read | CredentialConfidentialPersonal Data | По запросу |
| Amazon | OAuth через приложение Idovio | 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 | OAuth через приложение Idovio | account.discovercatalog.publishcatalog.readcatalog.updatefulfillment.writelisting.pauseorder.readprice.readprice.writerefund.writereturn.readstock.readstock.writetracking.write | CredentialPersonal DataSensitive Platform Data | Периодический опрос |
| Etsy | OAuth с PKCE | 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 | OAuth через приложение Idovio | account.discovermail.read | CredentialPersonal DataRestricted Platform Data | Периодический опрос |
| Google Ads | OAuth через приложение Idovio | 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 | OAuth через приложение Idovio | ads.budgetads.pauseads.read | CredentialSensitive Platform Data | По запросу |
| Microsoft Outlook | OAuth через приложение Idovio | 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 | OAuth через приложение Idovio | catalog.importcatalog.readcatalog.searchorder.cancelorder.createprice.readshipping.quotestock.readtracking.read | CredentialConfidentialPersonal Data | Периодический опрос |
| Printify | OAuth через приложение Idovio | 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 | OAuth через приложение Idovio | ads.budgetads.pauseads.read | CredentialSensitive Platform Data | По запросу |
| TikTok Shop | OAuth через приложение Idovio | 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