创建报告
POST
/openReport/report/task/createReport接口信息
此接口为异步创建
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/openReport/report/task/createReport | HTTPS | POST | 1 |
请求参数
reportOptionsobject必填reportTypeinteger必填dataStartTimestring必填dataEndTimestring必填sidsarray<any>必填midsarray<any>请求cURL示例
curl --location 'https://openapi.lingxing.com/openReport/report/task/createReport?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"reportType": 1,
"reportOptions": {
"dateType": 1
},
"dataStartTime": "2021-01-01 00:00:00",
"dataEndTime": "2021-01-31 23:59:59",
"sids": [
"1",
"2"
],
"mids": [
"1",
"2"
]
}'
返回结果
Json Object
codeinteger必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填dataobject必填隐藏子属性
reportIdstring必填返回成功示例
{
"code": 200,
"message": "success",
"error_details": [],
"request_id": "20210101123456789",
"response_time": "2021-01-01 12:34:56",
"data": {
"reportId": "20210101123456789"
}
}
附加说明
按json对象传
- 当传入reportType=1 (亚马逊订单)
可选字段:
|参数名|是否必填|说明| |--|--|--| |dateType|否|查询时间类型,可选值:1 - 订购时间【站点时间】 2 - 订单修改时间【北京时间】 3 - 平台更新时间【UTC时间】|
示例传入:{"dateType":1}
- 当传入reportType=2(产品表现)
可选字段:
|参数名|是否必填|说明| |--|--|--| |sort_field|是|排序条件,可选值:volume-销量,amount-金额| |sort_type|是|排序类型,可选值:desc-降序,asc-升序| |search_field|否|搜索条件,可选值:volume-销量;parent_asin-父asin;msku;local_sku-sku;item_name-标题| |summary_field|否|汇总行维度,可选值:asin-asin; parent_asin-父asin; msku-msku; sku-sku| |currency_code|否|货币类型转换,可选值:USD-美元;CNY-人民币| |is_recently_enum|否|是否仅查询活跃商品,可选值:true-仅活跃;false-所有商品|
当上述字段都传参时,示例:
{
"sort_field": "volume",
"sort_type": "desc",
"search_field": "volume",
"summary_field": "asin",
"currency_code": "USD"
}