获取购买记录
根据用户提交的素材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" } }