API工作原理

域名：capi-v2.sankakucomplex.com

通用请求头

下面的所有请求基本都有这几个请求头。除了UA都可以省略。

Accept: application/json, text/plain, */*
User-agent: SCChannelApp/4.2 (RNAndroid; black)
Connection: Keep-Alive

登录

请求地址、方法及头部：

POST https://capi-v2.sankakucomplex.com/auth/token
Content-Type: application/json

Body内容：

{
  "login": "***",
  "password": "***"
}

或者：

{
  "refresh_token": "***"
}

返回包含Token的json文本：

{
  "success": true,
  "token_type": "Bearer",
  "access_token": "***",
  "access_token_ttl": 604800,
  "refresh_token": "***",
  "refresh_token_ttl": 7776000
}

注意！Access Token的权限最低，有效期仅为一周，只用于执行查询和收藏管理。
Refresh Token与账号密码具有同等效力，但前者有效期为三个月。
在有效期内使用Refresh Token能刷新自身，理论上只要你每三个月内至少用过一次这个登录方法，就能达到跟账号密码一样的效果。

由此可见，请一定要保护好自己的账号密码还有Refresh Token。担心安全问题请使用Access Token登录。

查询图片

请求地址、方法及头部：

GET https://capi-v2.sankakucomplex.com/posts/keyset?limit=40&tags=***
Authorization: "Bearer ***"

***替换为Access Token。Bearer前缀必须要有，否则会返回401错误。

返回包含图片元数据的json文本。

注意，查询结果中有一个meta数组，其中的next字段是用于执行下一页查询的。
示例：

# 第一页查询
GET https://capi-v2.sankakucomplex.com/posts/keyset?page=1&limit=40&tags=***
# 第二页查询
GET https://capi-v2.sankakucomplex.com/posts/keyset?page=2&limit=40&tags=***&next=***

收藏管理

请求地址、方法及头部：

# 添加收藏
POST https://capi-v2.sankakucomplex.com/posts/{%id%}/favorite?lang=en
Authorization: "Bearer ***"
# 移除收藏
DELETE https://capi-v2.sankakucomplex.com/posts/{%id%}/favorite?lang=en
Authorization: "Bearer ***"

其中，{%id%}替换为目标帖子的id。

返回200状态码为成功。