V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
88250
V2EX  ›  分享创造

社区内容 API 开放,欢迎各位独立博客主进行连接

  •  4
     
  •   88250 ·
    88250 · 2016-03-05 14:22:13 +08:00 · 6750 次点击
    这是一个创建于 3187 天前的主题,其中的信息可能已经有所发展或是发生改变。

    状态

    • 这个方案还在不断修订中,开发实现方面已经基本完成,待大家反馈细节进一步改进后就正式发布
    • 最新的情况请看原帖

    下面进入正文。

    B3log 构思

    B3log 构思 目前已经基本实现, Solo黑客派现在已经可以稳定地进行帖子、回帖内容交互:

    • 使用 Solo 独立博客发布博文、评论会自动发布到黑客派社区
    • 在黑客派社区上发布帖子、回帖也会自动发布到 Solo 独立博客

    这样可以为博主带来更多的关注和互动,同时社区通过内容聚合也能够吸引更多用户。

    经过一段时间的实践验证,我们觉得内容交互的 API 可以不仅限于 Solo ,而应该开放给所有独立博客,让大家都加入进来共建这个生态!

    内容 API

    核心内容 API 一共有 4 个。前 3 个 APIs 由社区服务器实现,提供给博客进行调用;第 4 个 API 由博客实现,提供给社区进行调用:

    1. 博客发布博文 -> 社区发布帖子:在博客发布博文的同时调用社区的发帖,将博文内容同步到社区
    2. 博客更新博文 -> 社区更新帖子:在博客更新博文的同时调用社区的更新,将博文内容同步到社区
    3. 博客发布评论 -> 社区发布回帖:在博客发布评论的同时调用社区的回帖,将评论内容同步到社区
    4. 社区发布回帖 -> 博客发布评论:在社区回帖的同时调用博客的发布评论,将回帖内容同步到博客

    通过这 4 个 APIs 就可以实现博客和社区的相互连接,理论上博客还需要实现两个帖子同步博客的 APIs ,不过一般不常用,所以可以不必实现。

    社区账号

    要连接到社区前需要先到社区注册账号,其中最关键的是:

    • 注册时候使用的邮箱必须和博客用户的邮箱一致(调用 API 指定的实参),因为这个邮箱是用来鉴别连接身份的

    另外,还需要进行一下设置,请参考 黑客派客户端同步设置

    API 描述

    上面我们介绍了基本原理,下面就是各个 API 的详细描述了:

    TBD

    基础实现

    我们会提供一些主流编程语言的 API 基础实现,方便博客主调整代码。

    TBD


    OK ,要做什么我应该已经介绍清楚了,大家怎么看呢?

    第 1 条附言  ·  2016-03-07 15:23:24 +08:00

    文章发布 /更新的接口整理好了,请参考: https://hacpai.com/article/1457158841475

    第 2 条附言  ·  2016-03-08 23:44:46 +08:00
    评论的接口也整理好了~
    第 3 条附言  ·  2016-03-11 18:04:54 +08:00

    非常感谢 @DT27 实现了 Typecho 博客系统的连接插件: https://github.com/DT27/B3logForHacPai

    使用 Typecho 的同学可以来试用啦!

    第 4 条附言  ·  2016-03-12 20:15:18 +08:00

    辛苦两位啦~

    47 条回复    2016-04-08 12:40:02 +08:00
    oott123
        1
    oott123  
       2016-03-05 14:32:40 +08:00
    思路感觉很厉害,要是能把常用的几个博客系统做出插件来,应该会有不少人喜欢的。
    88250
        2
    88250  
    OP
       2016-03-05 14:40:01 +08:00
    @oott123 直接给出插件的话不大现实,但会提供各个语言的实现,在对应的地方插入代码就行啦
    oott123
        3
    oott123  
       2016-03-05 14:54:33 +08:00
    @88250 不会吧, WordPress / typecho 做到这些都很容易啊~
    supman
        4
    supman  
       2016-03-05 15:44:22 +08:00 via iPad
    嘿嘿 经常在 hacpai 发帖关于 java 的疑惑 谢谢 po 主解答
    88250
        5
    88250  
    OP
       2016-03-05 15:46:09 +08:00
    @supman 客气啦~
    DIYgod
        6
    DIYgod  
       2016-03-05 15:48:50 +08:00
    求 WordPress 支持
    itfanr
        7
    itfanr  
       2016-03-05 15:53:03 +08:00
    打通社区和博客,两边同步 hi 起来~~~
    88250
        8
    88250  
    OP
       2016-03-05 15:53:20 +08:00
    @DIYgod @oott123

    我不会 WP 等博客系统的插件编写,只能提供简单的代码,至于如何嵌入到已有博客系统中,还需要博主自己研究一下,也期待好心人来直接整合成插件
    88250
        9
    88250  
    OP
       2016-03-05 16:14:13 +08:00
    @itfanr 嗯嗯,是这么个意思
    zonghua
        10
    zonghua  
       2016-03-07 08:41:40 +08:00 via iPhone
    @88250 我来我来😄
    exoticknight
        11
    exoticknight  
       2016-03-07 08:55:52 +08:00
    看起来意思是用你们提供的 solo 博客?
    88250
        12
    88250  
    OP
       2016-03-07 09:04:04 +08:00
    @exoticknight 不一定非得用 Solo ,等 API 整理好后会发布多个语言的实现,这样就方便大家接入自己的博客系统了
    maddot
        13
    maddot  
       2016-03-07 09:27:57 +08:00
    这个思路很好啊,也新颖, wordpress 的插件可以放在重点,付费让别人做快点出来,等被人义务劳动不知道要等到猴年马月,质量也不能保证
    88250
        14
    88250  
    OP
       2016-03-07 09:35:43 +08:00 via Android
    @maddot 好建议,多谢!
    DT27
        15
    DT27  
       2016-03-07 09:42:27 +08:00
    说了这么多,翻了好几页也没找到 API 在哪啊。。。
    88250
        16
    88250  
    OP
       2016-03-07 09:54:00 +08:00
    @DT27 还在整理中,这周内应该可以完成,敬请期待
    DT27
        17
    DT27  
       2016-03-07 10:10:55 +08:00
    @88250 正在扒拉 b3log/solo 源码,期待啊~
    88250
        18
    88250  
    OP
       2016-03-07 10:25:49 +08:00
    @DT27 嗯嗯, API 设计上面也欢迎提供建议
    88250
        19
    88250  
    OP
       2016-03-07 15:24:00 +08:00   ❤️ 1
    @DT27 文章发布 /更新的接口整理好了,请参考: https://hacpai.com/article/1457158841475
    DT27
        20
    DT27  
       2016-03-07 15:32:29 +08:00
    @88250 (*@ο@*)
    ixiaozhi
        21
    ixiaozhi  
       2016-03-07 15:37:09 +08:00
    不如做成抓取,简介+流量引导到源站
    88250
        22
    88250  
    OP
       2016-03-07 15:39:30 +08:00   ❤️ 1
    @ixiaozhi 那要做的网站非常多。
    ixiaozhi
        23
    ixiaozhi  
       2016-03-07 15:44:10 +08:00
    @88250 提交网址再索引,为什么我想到了稀土。。。。。
    88250
        24
    88250  
    OP
       2016-03-07 15:50:33 +08:00
    @ixiaozhi 只是索引的话不好玩,要玩就玩真正的连接交互
    RqPS6rhmP3Nyn3Tm
        25
    RqPS6rhmP3Nyn3Tm  
       2016-03-07 20:55:20 +08:00 via iPad
    挺有意思的,希望有 Ghost 版本
    88250
        26
    88250  
    OP
       2016-03-07 20:59:41 +08:00 via Android
    @BXIA JS 的 SDK 会提供的,敬请期待,也希望来帮忙一起搞啊!
    RqPS6rhmP3Nyn3Tm
        27
    RqPS6rhmP3Nyn3Tm  
       2016-03-07 22:27:18 +08:00 via iPad
    @88250 对不起,我只会 C 和 Python , JS 一窍不通……
    88250
        28
    88250  
    OP
       2016-03-07 23:30:00 +08:00
    @BXIA Python 客户端也是需要的~
    dimlau
        29
    dimlau  
       2016-03-08 11:24:54 +08:00
    这个……
    很早之前 vanillaforums 就实现了这个功能啊。而且,并不需要 blog 端做什么适配,只要一段 JS 顺便托管了评论系统。
    dimlau
        30
    dimlau  
       2016-03-08 11:25:54 +08:00
    88250
        31
    88250  
    OP
       2016-03-08 11:45:04 +08:00
    @dimlau 完全不一样的思路。

    Vanilla Forums 是将其评论系统作为第三方评论系统集成到博客中,博客本身的评论系统就不用了。但是 B3log 的思路是博客本身的评论系统继续使用,只是将这个评论又转发到一个统一的社区中,两者之间数据上完全独立、互不影响。

    文章也是使用同样的方式来进行聚合、互连。博主不用担心第三方服务集成带来的问题(比如网络限制、数据丢失等),并且可以让自己的文章通过在社区聚合从而带来更多的关注和评论。
    dimlau
        32
    dimlau  
       2016-03-09 11:39:27 +08:00
    @88250 我是说,用一段 JS 也可以做到把 blog 文章推送到社区去。至于评论……
    是的是的,思路不同。各有利弊。
    88250
        33
    88250  
    OP
       2016-03-09 11:43:34 +08:00
    @dimlau 我懂你的意思了,无论如何,多谢你的反馈啦~
    88250
        34
    88250  
    OP
       2016-03-11 18:05:32 +08:00
    @DT27 你提供的插件我附言了,辛苦了!
    DT27
        35
    DT27  
       2016-03-11 20:03:10 +08:00
    @88250 嘿嘿,边学边做的~
    88250
        36
    88250  
    OP
       2016-03-12 20:15:47 +08:00
    @zonghua @zsx

    辛苦啦~
    88250
        37
    88250  
    OP
       2016-03-12 20:18:40 +08:00
    目前一共有三款博客提供了插件:

    * Typecho by @DT27
    * WordPress by @zonghua
    * Z-BlogPHP @zsx

    衷心感谢三位插件作者热心的支持。

    欢迎大家接入自己的博客到黑客派社区中,也欢迎大家提供更多的接入插件!
    zonghua
        38
    zonghua  
       2016-03-13 01:16:43 +08:00 via iPhone
    javascript 前端的插件可以怎么实现?像那些第三方评论系统
    RqPS6rhmP3Nyn3Tm
        39
    RqPS6rhmP3Nyn3Tm  
       2016-03-13 14:24:40 +08:00
    Ghost 没有插件系统,只能直接插 JS
    如果能和 Disqus 整合就更好了
    88250
        40
    88250  
    OP
       2016-03-14 10:01:27 +08:00
    @BXIA JS 版的 SDK 稍后推出~
    hiroya
        41
    hiroya  
       2016-03-16 13:04:43 +08:00 via iPad
    求个 hexo 的插件~
    hobbyliu
        42
    hobbyliu  
       2016-04-06 18:19:50 +08:00 via Android
    v2ex 啥时候支持?
    Showfom
        43
    Showfom  
       2016-04-06 19:50:52 +08:00
    看到 Solo 就想到了那个啥。。。。
    88250
        44
    88250  
    OP
       2016-04-06 22:38:45 +08:00
    @Showfom 要 LOL 还是 DoTA ? 23333

    @hobbyliu 什么意思呢?
    Showfom
        45
    Showfom  
       2016-04-06 22:50:05 +08:00
    @88250 不不不 Solo 是自 0.0 慰的意思
    88250
        46
    88250  
    OP
       2016-04-06 23:39:57 +08:00
    @Showfom 这个解,让我想起了。

    解:


    算了....
    aitaii
        47
    aitaii  
       2016-04-08 12:40:02 +08:00
    不知道为什么看到 把 b 和 3 连在一起 看到我浑身难受。。。(逃。。。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   5631 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 29ms · UTC 03:22 · PVG 11:22 · LAX 19:22 · JFK 22:22
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.