获取购买记录
根据用户提交的素材id或时间范围查询购买记录明细
接口地址(URI): /api/pa/creative/purchase_log
HTTP请求方式:GET
请求参数:
| 请求值字段 | 必选 | 类型 | 说明 |
|---|---|---|---|
| photo_id | false | string | 素材编号(res_id),仅可输入一个. (使用此项参数,将导致请求的“购买开始时间”和“购买结束时间”无效) |
| start_date | false | string | 请求查询购买记录明细的开始日期。 格式:2017-07-01,精确到天 |
| end_date | false | string | 请求查询购买记录明细的结束日期 (与“开始时间”的时间差不能超过31天)。格式:2017-07-31 |
| page | false | integer | 哪一页 |
| nums | false | integer | 每页返回数据的最大值 |
| account_id | false | integer | 请求查询的客户id(如不清楚您的客户id,请与商务代表联系) |
| down_id | false | string | 根据自定义的下载记录id获取下载记录,多条id用“;”分隔。当请求down_id成功时,photo_id、account_id、start_date、end_date请求失效 |
| username | false | string | 用户名(仅限客户组织架构有父子关系的部分客户使用) |
返回参数:
| 返回字段 | 说明 |
|---|---|
| purchase_id | 购买记录id(每条购买记录唯一代码) |
| photo_id | 资源id |
| download_time | 下载时间 |
| small_url | 预览地址 |
| purchase_size | 购买尺寸 |
| user_name | 用户名 |
| real_name | 真实姓名 |
| asset_family | 媒资分类:1=资讯类 2=创意类 |
| effective_time | 生效时间 |
| license_type | 授权类型1=RM;2=RF |
| total_count | 总数量 |
| total_page | 总页数 |
| per_page | 每页数量 |
| cur_page | 当前页码 |
请求参数示例example value:
Curl: curl -X GET --header 'Accept: application/json' --header 'api-key: xxxxxxxxxxxxxxxxxxxxxxxxx' --header 'authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' 'https://api.fotomore.com/api/pa/creative/purchase_log?start_date=2021-11-10&end_date=2021-11-11&nums=1' Request URL: https://api.fotomore.com/api/pa/creative/purchase_log?start_date=2021-11-10&end_date=2021-11-11&nums=1
返回数据示例example value:
{
"status_code": 1,
"message": "ok",
"data": {
"list": [
{
"purchase_id": null,
"photo_id": "VCG215714fe5af",
"download_time": "2021-07-29 15:09:58",
"small_url": "https://photo-static-api.fotomore.com/creative/vcg/176/new/VCG215714fe5af.jpg",
"purchase_size": "1700",
"user_name": "meituanapi",
"real_name": "美团API",
"asset_family": 2,
"effective_time": "2021-07-29 17:47:57",
"license_type": "RF"
},
{
"purchase_id": null,
"photo_id": "VCG211199188425",
"download_time": "2021-07-29 15:01:29",
"small_url": "https://photo-static-api.fotomore.com/creative/vcg/176/new/VCG211199188425.jpg",
"purchase_size": "1700",
"user_name": "meituanapi",
"real_name": "美团API",
"asset_family": 2,
"effective_time": "2021-07-29 17:47:57",
"license_type": "RF"
}
],
"total_count": 201,
"total_page": 101,
"per_page": "2",
"cur_page": "1"
}
}