API References

post
/open-api/taobao/fetch-products
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Body
thirdPartystringRequired
credentialAccountstringRequired
originalIdstringRequired
Responses
200

OK

*/*
post
/open-api/taobao/fetch-products
POST /open-api/taobao/fetch-products HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "thirdParty": "text",
  "credentialAccount": "text",
  "originalId": "text"
}
200

OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "marketplace": "text",
  "merchant": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "tenant": "text",
    "marketplace": "text",
    "code": "text",
    "oid": "text",
    "name": "text"
  },
  "code": "text",
  "oid": "text",
  "mappingId": "text",
  "url": "text",
  "title": "text",
  "description": "text",
  "detail": "text",
  "productImages": [
    "text"
  ],
  "brand": "text",
  "material": "text",
  "marketSegment": "text",
  "stock": 1,
  "totalSold": 1,
  "msrp": 1,
  "salePrice": 1,
  "invoicePrice": 1,
  "currency": "text",
  "overallRating": 1,
  "totalRates": 1,
  "limitQuantity": 1,
  "quantity": 1,
  "skus": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "code": "text",
      "oid": "text",
      "merchantId": "123e4567-e89b-12d3-a456-426614174000",
      "url": "text",
      "name": "text",
      "images": [
        "text"
      ],
      "stock": 1,
      "batchSize": 1,
      "minQuantity": 1,
      "totalSold": 1,
      "msrp": 1,
      "salePrice": 1,
      "invoicePrice": 1,
      "variantProperties": [
        {
          "id": "text",
          "name": "text",
          "originalName": "text",
          "value": "text",
          "originalValue": "text",
          "pid": "text"
        }
      ],
      "specId": "text",
      "skuId": "text",
      "skuHash": "text",
      "unit": "text",
      "limitQuantity": 1,
      "quantity": 1,
      "currency": "text"
    }
  ]
}
post
/open-api/taobao/build-product-relation
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Body
thirdPartystringRequired
credentialAccountstringRequired
itemIdsstring[]Required
Responses
200

OK

*/*
post
/open-api/taobao/build-product-relation
POST /open-api/taobao/build-product-relation HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "thirdParty": "text",
  "credentialAccount": "text",
  "itemIds": [
    "text"
  ]
}
200

OK

{
  "code": "text",
  "type": "text",
  "message": "text",
  "success": true,
  "data": [
    "text"
  ],
  "request_id": "text",
  "fail_items": [
    {
      "error_message": "text",
      "item_id": "text",
      "error_code": "text"
    }
  ],
  "error_code": "text",
  "error_msg": "text"
}
get
/open-api/orders
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Responses
200

OK

*/*
get
/open-api/orders
GET /open-api/orders?criteria=[object+Object] HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
200

OK

[
  {
    "createdAt": "2025-12-06T03:39:16.908Z",
    "createdBy": "text",
    "modifiedAt": "2025-12-06T03:39:16.908Z",
    "modifiedBy": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "tenant": "text",
    "username": "text",
    "code": "text",
    "credentialAccount": "text",
    "thirdParty": "text",
    "globalOrderId": "text",
    "purchaseOrderId": "text",
    "merchantShippingCost": 1,
    "payAmount": 1,
    "payCurrency": "text",
    "purchaseAmount": 1,
    "purchaseCurrency": "text",
    "globalStatus": "text",
    "status": "text",
    "lastFetch": "2025-12-06T03:39:16.908Z",
    "timestamp": "2025-12-06T03:39:16.908Z",
    "note": "text",
    "image": "text",
    "totalSku": 1,
    "products": [
      {
        "createdAt": "2025-12-06T03:39:16.908Z",
        "createdBy": "text",
        "modifiedAt": "2025-12-06T03:39:16.908Z",
        "modifiedBy": "text",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "tenant": "text",
        "username": "text",
        "code": "text",
        "orderId": "123e4567-e89b-12d3-a456-426614174000",
        "orderCode": "text",
        "oid": "text",
        "mappingSkuId": "text",
        "mappingProductId": "text",
        "actualPrice": 1,
        "quantity": 1,
        "title": "text",
        "url": "text",
        "imageUrl": "text",
        "originalReceiptCode": "text",
        "subOriginalReceiptCode": "text",
        "subPurchaseId": "text"
      }
    ]
  }
]
post
/open-api/orders
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Body
thirdPartystringRequired
accountstringRequired
Responses
200

OK

*/*
post
/open-api/orders
POST /open-api/orders HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 298

{
  "skus": [
    {
      "quantity": 1,
      "unitPrice": 1,
      "mappingProductId": "text",
      "mappingSkuId": "text",
      "oid": "text"
    }
  ],
  "thirdParty": "text",
  "account": "text",
  "address": {
    "country": "text",
    "zipCode": "text",
    "address1": "text",
    "city": "text",
    "phone": "text",
    "mobile": "text",
    "district": "text",
    "state": "text",
    "recipient": "text"
  }
}
200

OK

{
  "createdAt": "2025-12-06T03:39:16.908Z",
  "createdBy": "text",
  "modifiedAt": "2025-12-06T03:39:16.908Z",
  "modifiedBy": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "tenant": "text",
  "username": "text",
  "code": "text",
  "credentialAccount": "text",
  "thirdParty": "text",
  "globalOrderId": "text",
  "purchaseOrderId": "text",
  "merchantShippingCost": 1,
  "payAmount": 1,
  "payCurrency": "text",
  "purchaseAmount": 1,
  "purchaseCurrency": "text",
  "globalStatus": "text",
  "status": "text",
  "lastFetch": "2025-12-06T03:39:16.908Z",
  "timestamp": "2025-12-06T03:39:16.908Z",
  "note": "text",
  "image": "text",
  "totalSku": 1,
  "products": [
    {
      "createdAt": "2025-12-06T03:39:16.908Z",
      "createdBy": "text",
      "modifiedAt": "2025-12-06T03:39:16.908Z",
      "modifiedBy": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "tenant": "text",
      "username": "text",
      "code": "text",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "orderCode": "text",
      "oid": "text",
      "mappingSkuId": "text",
      "mappingProductId": "text",
      "actualPrice": 1,
      "quantity": 1,
      "title": "text",
      "url": "text",
      "imageUrl": "text",
      "originalReceiptCode": "text",
      "subOriginalReceiptCode": "text",
      "subPurchaseId": "text"
    }
  ]
}
post
/open-api/orders/{code}/pay-purchase-order
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
codestringRequired
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Responses
200

OK

*/*
post
/open-api/orders/{code}/pay-purchase-order
POST /open-api/orders/{code}/pay-purchase-order HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
200

OK

{
  "createdAt": "2025-12-06T03:39:16.908Z",
  "createdBy": "text",
  "modifiedAt": "2025-12-06T03:39:16.908Z",
  "modifiedBy": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "tenant": "text",
  "username": "text",
  "code": "text",
  "credentialAccount": "text",
  "thirdParty": "text",
  "globalOrderId": "text",
  "purchaseOrderId": "text",
  "merchantShippingCost": 1,
  "payAmount": 1,
  "payCurrency": "text",
  "purchaseAmount": 1,
  "purchaseCurrency": "text",
  "globalStatus": "text",
  "status": "text",
  "lastFetch": "2025-12-06T03:39:16.908Z",
  "timestamp": "2025-12-06T03:39:16.908Z",
  "note": "text",
  "image": "text",
  "totalSku": 1,
  "products": [
    {
      "createdAt": "2025-12-06T03:39:16.908Z",
      "createdBy": "text",
      "modifiedAt": "2025-12-06T03:39:16.908Z",
      "modifiedBy": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "tenant": "text",
      "username": "text",
      "code": "text",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "orderCode": "text",
      "oid": "text",
      "mappingSkuId": "text",
      "mappingProductId": "text",
      "actualPrice": 1,
      "quantity": 1,
      "title": "text",
      "url": "text",
      "imageUrl": "text",
      "originalReceiptCode": "text",
      "subOriginalReceiptCode": "text",
      "subPurchaseId": "text"
    }
  ]
}
Deprecated
get
/open-api/taobao/product-detail
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
itemIdsstring[]Required
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Responses
200

OK

*/*
get
/open-api/taobao/product-detail
GET /open-api/taobao/product-detail?itemIds=text HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
200

OK

{
  "code": "text",
  "type": "text",
  "message": "text",
  "success": true,
  "data": {
    "goods_info_list": [
      {
        "images": [
          "text"
        ],
        "skus": [
          {
            "createdAt": "2025-12-06T03:39:16.908Z",
            "createdBy": "text",
            "modifiedAt": "2025-12-06T03:39:16.908Z",
            "modifiedBy": "text",
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "tenant": "text",
            "username": "text",
            "productId": "123e4567-e89b-12d3-a456-426614174000",
            "itemId": "text",
            "skuId": "text",
            "inventory": "text",
            "quantity": 1,
            "images": "text",
            "price": 1,
            "width": "text",
            "length": "text",
            "weight": "text",
            "status": "text",
            "currency": "text",
            "attributes": "text"
          }
        ],
        "sourceMarket": "text",
        "title": "text",
        "inventory": "text",
        "tagList": [
          "text"
        ],
        "success": "text",
        "price": 1,
        "currency": "text",
        "attributes": [
          {
            "vid": 1,
            "pid": 1,
            "vTextMulti": {
              "anyValue": {
                "present": true
              },
              "langAndValueMap": {
                "CN_zh": {
                  "value": "text"
                },
                "US_en": {
                  "value": "text"
                }
              },
              "notEmpty": true,
              "empty": true,
              "default": {
                "present": true
              }
            },
            "pTextMulti": {
              "anyValue": {
                "present": true
              },
              "langAndValueMap": {
                "CN_zh": {
                  "value": "text"
                },
                "US_en": {
                  "value": "text"
                }
              },
              "notEmpty": true,
              "empty": true,
              "default": {
                "present": true
              }
            }
          }
        ],
        "status": "text",
        "tb_category_path": "text",
        "error_msg": "text",
        "category_name": "text",
        "item_id": "text",
        "brand_name": "text",
        "spu_attributes": [
          {
            "vid": 1,
            "pid": 1,
            "vTextMulti": {
              "anyValue": {
                "present": true
              },
              "langAndValueMap": {
                "CN_zh": {
                  "value": "text"
                },
                "US_en": {
                  "value": "text"
                }
              },
              "notEmpty": true,
              "empty": true,
              "default": {
                "present": true
              }
            },
            "pTextMulti": {
              "anyValue": {
                "present": true
              },
              "langAndValueMap": {
                "CN_zh": {
                  "value": "text"
                },
                "US_en": {
                  "value": "text"
                }
              },
              "notEmpty": true,
              "empty": true,
              "default": {
                "present": true
              }
            }
          }
        ],
        "short_title": "text",
        "supplier_nick": "text",
        "category_id": "text",
        "cn_title": "text",
        "rich_text": "text",
        "tb_category_id": "text",
        "error_code": "text"
      }
    ]
  },
  "request_id": "text",
  "fail_items": [
    {
      "error_message": "text",
      "item_id": "text",
      "error_code": "text"
    }
  ],
  "error_code": "text",
  "error_msg": "text"
}
Deprecated
get
/open-api/taobao/origin-product-info
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
itemIdstringRequired
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Responses
200

OK

*/*
get
/open-api/taobao/origin-product-info
GET /open-api/taobao/origin-product-info?itemId=text HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
200

OK

{
  "code": "text",
  "type": "text",
  "message": "text",
  "success": true,
  "data": {
    "quantity": 1,
    "mp_id": "text",
    "category_name": "text",
    "item_id": 1,
    "item_type": "text",
    "description": "text",
    "pic_urls": [
      "text"
    ],
    "begin_amount": 1,
    "shop_name": "text",
    "title": "text",
    "user_nick": "text",
    "promotion_price": 1,
    "shop_id": 1,
    "category_id": "text",
    "category_path": "text",
    "price": 1,
    "sku_list": [
      {
        "createdAt": "2025-12-06T03:39:16.908Z",
        "createdBy": "text",
        "modifiedAt": "2025-12-06T03:39:16.908Z",
        "modifiedBy": "text",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "tenant": "text",
        "username": "text",
        "productId": "123e4567-e89b-12d3-a456-426614174000",
        "itemId": "text",
        "skuId": "text",
        "inventory": "text",
        "quantity": 1,
        "images": "text",
        "price": 1,
        "width": "text",
        "length": "text",
        "weight": "text",
        "status": "text",
        "currency": "text",
        "attributes": "text"
      }
    ],
    "status": "text"
  },
  "request_id": "text",
  "fail_items": [
    {
      "error_message": "text",
      "item_id": "text",
      "error_code": "text"
    }
  ],
  "error_code": "text",
  "error_msg": "text"
}
get
/open-api/orders/{code}
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
codestringRequired
Header parameters
X-TenantstringRequired
Client-Idstring · uuidRequired
Responses
200

OK

*/*
get
/open-api/orders/{code}
GET /open-api/orders/{code} HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
200

OK

{
  "createdAt": "2025-12-06T03:39:16.908Z",
  "createdBy": "text",
  "modifiedAt": "2025-12-06T03:39:16.908Z",
  "modifiedBy": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "tenant": "text",
  "username": "text",
  "code": "text",
  "credentialAccount": "text",
  "thirdParty": "text",
  "globalOrderId": "text",
  "purchaseOrderId": "text",
  "merchantShippingCost": 1,
  "payAmount": 1,
  "payCurrency": "text",
  "purchaseAmount": 1,
  "purchaseCurrency": "text",
  "globalStatus": "text",
  "status": "text",
  "lastFetch": "2025-12-06T03:39:16.908Z",
  "timestamp": "2025-12-06T03:39:16.908Z",
  "note": "text",
  "image": "text",
  "totalSku": 1,
  "products": [
    {
      "createdAt": "2025-12-06T03:39:16.908Z",
      "createdBy": "text",
      "modifiedAt": "2025-12-06T03:39:16.908Z",
      "modifiedBy": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "tenant": "text",
      "username": "text",
      "code": "text",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "orderCode": "text",
      "oid": "text",
      "mappingSkuId": "text",
      "mappingProductId": "text",
      "actualPrice": 1,
      "quantity": 1,
      "title": "text",
      "url": "text",
      "imageUrl": "text",
      "originalReceiptCode": "text",
      "subOriginalReceiptCode": "text",
      "subPurchaseId": "text"
    }
  ]
}
get
/open-api/client-account
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
Header parameters
X-TenantstringRequired
Client-IdstringRequired
Responses
200

OK

*/*
get
/open-api/client-account
GET /open-api/client-account?queryCriteria=[object+Object] HTTP/1.1
Host: inai.dota.gobizdev.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Tenant: text
Client-Id: text
Accept: */*
200

OK

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "tenant": "text",
    "username": "text",
    "clientId": "123e4567-e89b-12d3-a456-426614174000",
    "clientCode": "text",
    "account": "text",
    "thirdParty": "text"
  }
]

Last updated