API文档 v1.0.0
说明

API地址: http://bog.ac/api

例:

  • http://bog.ac/api/p/1/0
  • 目前共三个参数:

  • mode,也就是API类型
  • data1,第一个参数
  • data2,第二个参数
  • 参数只能为整数,mode只能为已提供的api mode。

    必须三个参数齐全才会返回数据。

    mod p (page)

    获得指定页面的串

    例:

  • http://bog.ac/api/p/1/0 获取第一页的串
  • 参数:

  • mode : p
  • data1 : 页码 //从1开始,小于1则当做1处理)
  • data2 : 板块 //由于目前没有板块功能,所以这个参数无效,默认0
  • 其他说明:

  • "no": "4744" //串号
  • "res": 0 //这个串的主串,也就是它的回复目标,自身为主串的时候则为0
  • "title": "" //标题,为空则不处理
  • "name": "" //昵称,为空则显示为无名氏,也可以换成其他词
  • "com": "\u8fd8\u6709\u5565\u533f\u540d\u8bba\u575b\u554a\uff1f" //内容
  • "time": "19-11-22(\u4e94)17:36:55" //时间
  • "id": "qsSUvfC2" //饼干
  • "img": "" //图片的预览图链接(小图)
  • "src": "" //图片的原图链接
  • "ext": "" //图片的后缀
  • "lock": 0 //是否被锁定,1为锁定,锁定的串不能回复
  • "htmb": 1 //图片有没有被红名干掉,1为干掉了,如果被红名干掉则这个串的图片信息就会是空的,用于显示酷炫的“红名办事,图已替换( ^ω^)”
  • "sage": 0 //1为sage
  • "admin": 0 //是否为权限狗,1为是,一般情况下不会出现2,除非为了节目效果。(总之不是0的就是红名)
  • "hr": 0 //表示这个串还有多少个回复没有被显示,就是“还有 2 条回复,可点击回复按钮查看。”这里需要的,不需要刻意忽略
  • "replys": [] //调出这个串最后的5个回复,如果客户端不需要解析可以忽略,需要则含义同上
  • mod t (threads)

    获得指定串(主串)

    例:

  • http://bog.ac/api/t/4745/1 //获取4745这个串的第1页)
  • 参数:

  • mode : t
  • data1 : 串号 //必须为主串
  • data2 : 页码 //同上
  • 其他说明:

  • 大部分情况和上面一样,不过replys解析的并不是最后5个回复,而是这一页的所有回复,最多20个
  • mod r (replys)

    获得指定串(任意,单条)

    例:

  • http://bog.ac/api/r/4745/0 //获取4745这个串的数据)
  • 参数:

  • mode : t
  • data1 : 串号 //任意
  • data2 : 0 //会被忽略,所以写0就行了
  • 其他说明:

  • 大部分情况和上面的一样。
  • error (返回错误)

    传递错误的参数时就会返回错误

    例:

  • {"error":"1"}
  • 错误ID对应的说明:

  • 0 : 不存在的API
  • 1 : 不存在的串
  • 2 : 不存在的页面
  • 3 : 不存在的串(mod:r)
  • 其他 : 没有
  • 其他

    一些本地处理需要的api

    解析av号:

  • https://api.kaaass.net/biliapi/video/info?id={av号} //写数字即可,如114514
  • 该api及其他biliapi的文档由http://api.kaaass.net/biliapi/提供,本文档不再赘述
  • 解析a岛串号:

  • https://nmb.fastmirror.org/Api/ref?id={串号} //A岛提供的api
  • http://bog.ac/adnmb.php?id={串号}&json=1 //本站用于缓存A岛串的api,如果本站缓存过则永久可解析