主页批量去水印接口开发文档
该接口为作者主页批量提取接口,亨亨猫「作者主页批量提取」功能支持的平台,该接口都支持。
接口地址:https://h.aaaapp.cn/posts
请求方式:POST
请求Content-Type:application/json
接口参数:
参数 | 说明 |
---|---|
userId | 在开发者接口管理中心获取 |
secretKey | 在开发者接口管理中心获取 |
url | 作者主页分享链接地址 |
cursor | 分页参数,获取第1页不传该参数,获取第2页传前一页请求结果里的next_cursor的数据 |
请求成功的返回结果:
{
"code": 200,
"succ": true,
"data": {
"next_cursor": "4738017350125975",
"has_more": true,
"posts": [
{
"id": 4740201740502412,
"create_time": 1645635626000,
"text": "旧电脑千万不要扔,一招让它比新电脑还流畅!",
"medias": [
{
"media_type": "video",
"resource_url": "http://f.video.weibocdn.com/o0/OKxyGGNvlx07TZHhMZlC01041200jdfp0E010.mp4?label=mp4_720p&template=720x1056.24.0&ori=0&ps=1CwnkDw1GXwCQx&Expires=1645685774&ssig=reKoohgbtK&KID=unistore,video",
"preview_url": "http://wx1.sinaimg.cn/orj480/60c32e03ly1gznxqvfvs5j20k00qpad8.jpg"
}
]
},
{
"id": 4740187936000074,
"create_time": 1645632335000,
"text": "勤练3年的肚皮舞,大家觉得如何?",
"medias": [
{
"media_type": "image",
"resource_url": "http://wx3.sinaimg.cn/orj480/60c32e03ly1gznw662vcxj20k00sw75q.jpg"
"preview_url": null
}
]
}
],
"user": {
"username": "泡泡Pisces",
"avatar": null
},
"overseas": 0
}
}
返回结果字段说明:
字段 | 说明 | 是否一定有值 |
---|---|---|
has_more | true: 有下一页;false: 没有下一页了 | 一定有 |
next_cursor | 获取下一页数据时,将该值作为cursor参数值传递。 如果has_more为false,则没有下一页了,此字段值为'no_more' |
一定有 |
posts | 每页返回多个帖子(post),posts是帖子列表数据 | 可能返回空数组 |
posts -> text | 帖子的文案 | 可能没有 |
posts -> medias | 每个帖子里包含一个或多个媒体资源(视频/图片) | 一定有 |
posts -> medias -> media_type | 目前有两种类型:视频(video)、图片(image) | 一定有 |
posts -> medias -> resource_url | 资源url,如果media_type是video, 则是视频地址;如果media_type是image,则是图片地址 | 一定有 |
posts -> medias -> preview_url | 资源预览url,如果media_type是video, 则是视频封面;如果media_type是image,则没有(null) | 可能没有 |
user -> username | 博主昵称 | 可能没有 |
user -> avatar | 博主头像网址 | 可能没有 |
请求失败的返回结果:
{
code: 400,
msg: "缺少参数"
}
返回状态码说明:
code | msg |
---|---|
200 | 提取成功,code为200时代表成功,其他code代表失败 |
402 | 接口调用额度已用完,请充值再使用 |
401 | 缺少参数userId或secretKey |
userId和secretKey不匹配 | |
其他code | 缺少参数 |
请传入正确的url地址 | |
提取失败 | |
-30 | 如果code是-30,表示当前服务异常(出现率极低),可重试该次请求 |