Lingxing
切换旧版

查询Shopify在线商品

POST/basicOpen/multiplatform/shopify/variantList

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/shopify/variantListHTTPSPOST1

请求参数

principalUidsarray<any>
负责人用户ID列表
store_idsarray<any>
店铺Id
statusarray<any>
状态
1、Active
2、Draft
3、Archived
4、Deleted
inventory_policyarray<any>
库存策略
1、不跟踪库存
2、缺货停止销售
3、缺货继续销售
type_idarray<any>
分类Id
offsetinteger
分页偏移量
lengthinteger
分页长度，上限1000
search_fieldinteger
搜索维度
search_single_valuestring
模糊搜索值
search_valuesarray<any>
精确搜索列表，上限200个
quantitystring
库存数量
quantity_conditioninteger
库存数量大于或小于
1、大于
2、小于
priceinteger
售价
price_conditioninteger
售价大于或小于
1、大于
2、小于
listing_time_fieldinteger
时间维度
listing_start_timestring
开始时间
listing_end_timestring
结束时间

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/shopify/variantList?access_token=value&sign=value&timestamp=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "principalUids": [10001,10002],
    "store_ids": ["value"],
    "status": ["value"],
    "inventory_policy": ["value"],
    "offset": value,
    "length": value,
    "search_field": value,
    "search_single_value": "value",
    "quantity": "value",
    "quantity_condition": value,
    "price": "value",
    "price_condition": value,
    "listing_time_field": value,
    "listing_start_time": "value",
    "listing_end_time": "value"
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
response_timestring必填
响应时间
示例 2024-09-10 10:19:07
dataobject必填
响应数据
隐藏子属性
countnumber必填
总数
示例 13
listarray<object>必填
隐藏子属性
weightstring必填
重量
示例 0
item_idstring必填
商品Id
示例 6700083839169
item_urlstring必填
商品链接
product_unique_idstring必填
产品uid
示例 901286166546538496
variant_unique_idstring必填
子体uid
示例 901286161295692288
company_idstring必填
企业Id
示例 901157321452879872
parent_picture_urlstring必填
父图链接
picture_urlstring必填
图片链接
parent_mskustring必填
父MSKU
mskustring必填
MSKU
示例 custom003
parent_attributestring必填
母体属性
示例 Size/Color
attributestring必填
变体属性
示例 42 / red
titlestring必填
标题
示例 定制产品
local_skustring必填
SKU
示例 test061302sku
pidstring必填
本地商品id
local_namestring必填
品名
示例 test061302pm
store_idstring必填
店铺Id
示例 110000000018002001
store_namestring必填
店铺名称
pricestring必填
售价
示例 900.00
quantitystring必填
库存
示例 111
currency_iconstring必填
货币图标
示例 ￥
has_variantboolean必填
是否有子体
示例 false
listing_start_timestring必填
开始时间
示例 2021-05-10 11:07:44
listing_end_timestring必填
结束时间
示例 2021-10-26 17:26:08
statusnumber必填
商品状态：
1 active
2 draft
3 archived
4 deleted
示例 1
status_namestring必填
商品状态：
1 active
2 draft
3 archived
4 deleted
示例 active
inventory_policyinteger必填
库存策略：
1不跟踪库存
2缺货停止销售
3缺货继续销售
示例 3
inventory_policy_namestring必填
库存策略：
1不跟踪库存
2缺货停止销售
3缺货继续销售
示例 缺货继续销售
type_idstring必填
商品分类Id
示例 0
type_namestring必填
商品分类名
requires_shippingboolean必填
是否需要运输
0、否
1、是
示例 true
taxableboolean必填
出售产品变体时是否要征税
0、否
1、是
示例 true
min_weightinteger必填
最小重量
max_weightinteger必填
最大重量
weight_unitstring必填
重量单位
示例 kg
location_infosarray<object>必填
商品所在地详细信息
隐藏子属性
quantity_adjust_afterstring必填
库存调整后的值
quantity_adjust_beforestring必填
库存调整前的值
quantity_user_idstring必填
库存调整操作人id
quantity_user_id_namestring必填
库存调整操作人名字
quantity_queue_typeinteger必填
库存队列类型
示例 0
quantity_queue_statusstring必填
库存队列状态
示例 0
location_namestring必填
商品所在地名称
location_quantitystring必填
location库存
示例 111
location_idstring必填
商品所在地id
示例 64418349246
totalinteger必填
总数
示例 0

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.148.17261287335766689",
    "response_time": "2024-09-12 16:12:14",
    "data": {
        "count": 1,
        "list": [
            {
                "weight": "2",
                "item_id": "6768632430804",
                "item_url": "",
                "product_unique_id": "9012162617856",
                "variant_unique_id": "9019162671616",
                "company_id": "9011572879872",
                "parent_picture_url": "",
                "picture_url": "",
                "parent_msku": null,
                "msku": "B0106008",
                "parent_attribute": "SHIP TO/Color",
                "attribute": "EU / Blue",
                "title": "ERYONE PETG Filament, 1.75mm ±0.03mm Filament for 3D Printer, 1KG(2.2LBS)/ Spool",
                "local_sku": "test061302sku",
                "pid": null,
                "local_name": "test061302pm",
                "store_id": "110000000018002001",
                "store_name": "shopify测试店铺",
                "price": "27.99",
                "quantity": "17",
                "currency_icon": "￥",
                "has_variant": false,
                "listing_start_time": "2021-09-10 15:40:51",
                "listing_end_time": "2022-04-12 11:46:56",
                "status": 1,
                "status_name": "active",
                "inventory_policy": 2,
                "inventory_policy_name": "缺货停止销售",
                "type_id": "901235959162748928",
                "type_name": "PETG",
                "requires_shipping": true,
                "taxable": false,
                "min_weight": null,
                "max_weight": null,
                "weight_unit": "lb",
                "location_infos": []
            }
        ]
    },
    "total": 0
}