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

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

爱意满满的作品展示区。

这是一个创建于 3184 天前的主题，其中的信息可能已经有所发展或是发生改变。

状态

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

下面进入正文。

B3log 构思

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

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

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

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

内容 API

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

博客发布博文 -> 社区发布帖子：在博客发布博文的同时调用社区的发帖，将博文内容同步到社区
博客更新博文 -> 社区更新帖子：在博客更新博文的同时调用社区的更新，将博文内容同步到社区
博客发布评论 -> 社区发布回帖：在博客发布评论的同时调用社区的回帖，将评论内容同步到社区
社区发布回帖 -> 博客发布评论：在社区回帖的同时调用博客的发布评论，将回帖内容同步到博客

通过这 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

[WordPress] by @zonghua ：https://github.com/zh-h/hacpai-sync-wordpress
[Z-BlogPHP] by @zsx ：https://github.com/zblogapp/hacpai

辛苦两位啦~

博客

社区

API

调用

47 条回复 • 2016-04-08 12:40:02 +08:00

oott123

2016-03-05 14:32:40 +08:00

思路感觉很厉害，要是能把常用的几个博客系统做出插件来，应该会有不少人喜欢的。

88250

2016-03-05 14:40:01 +08:00

@oott123 直接给出插件的话不大现实，但会提供各个语言的实现，在对应的地方插入代码就行啦

oott123

2016-03-05 14:54:33 +08:00

@88250 不会吧， WordPress / typecho 做到这些都很容易啊~

supman

2016-03-05 15:44:22 +08:00 via iPad

嘿嘿经常在 hacpai 发帖关于 java 的疑惑谢谢 po 主解答

88250

2016-03-05 15:46:09 +08:00

@supman 客气啦~

DIYgod

2016-03-05 15:48:50 +08:00

求 WordPress 支持

itfanr

2016-03-05 15:53:03 +08:00

打通社区和博客，两边同步 hi 起来~~~

88250

2016-03-05 15:53:20 +08:00

@DIYgod @oott123

我不会 WP 等博客系统的插件编写，只能提供简单的代码，至于如何嵌入到已有博客系统中，还需要博主自己研究一下，也期待好心人来直接整合成插件

88250

2016-03-05 16:14:13 +08:00

@itfanr 嗯嗯，是这么个意思

zonghua

2016-03-07 08:41:40 +08:00 via iPhone

@88250 我来我来😄

exoticknight

2016-03-07 08:55:52 +08:00

看起来意思是用你们提供的 solo 博客？

88250

2016-03-07 09:04:04 +08:00

@exoticknight 不一定非得用 Solo ，等 API 整理好后会发布多个语言的实现，这样就方便大家接入自己的博客系统了

maddot

2016-03-07 09:27:57 +08:00

这个思路很好啊，也新颖， wordpress 的插件可以放在重点，付费让别人做快点出来，等被人义务劳动不知道要等到猴年马月，质量也不能保证

88250

2016-03-07 09:35:43 +08:00 via Android

@maddot 好建议，多谢！

DT27

2016-03-07 09:42:27 +08:00

说了这么多，翻了好几页也没找到 API 在哪啊。。。

88250

2016-03-07 09:54:00 +08:00

@DT27 还在整理中，这周内应该可以完成，敬请期待

DT27

2016-03-07 10:10:55 +08:00

@88250 正在扒拉 b3log/solo 源码，期待啊~

88250

2016-03-07 10:25:49 +08:00

@DT27 嗯嗯， API 设计上面也欢迎提供建议

88250

2016-03-07 15:24:00 +08:00

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

DT27

2016-03-07 15:32:29 +08:00

@88250 (*@ο@*)

ixiaozhi

2016-03-07 15:37:09 +08:00

不如做成抓取，简介+流量引导到源站

88250

2016-03-07 15:39:30 +08:00

@ixiaozhi 那要做的网站非常多。

ixiaozhi

2016-03-07 15:44:10 +08:00

@88250 提交网址再索引，为什么我想到了稀土。。。。。

88250

2016-03-07 15:50:33 +08:00

@ixiaozhi 只是索引的话不好玩，要玩就玩真正的连接交互

RqPS6rhmP3Nyn3Tm

2016-03-07 20:55:20 +08:00 via iPad

挺有意思的，希望有 Ghost 版本

88250

2016-03-07 20:59:41 +08:00 via Android

@BXIA JS 的 SDK 会提供的，敬请期待，也希望来帮忙一起搞啊！

RqPS6rhmP3Nyn3Tm

2016-03-07 22:27:18 +08:00 via iPad

@88250 对不起，我只会 C 和 Python ， JS 一窍不通……

88250

2016-03-07 23:30:00 +08:00

@BXIA Python 客户端也是需要的~

dimlau

2016-03-08 11:24:54 +08:00

这个……
很早之前 vanillaforums 就实现了这个功能啊。而且，并不需要 blog 端做什么适配，只要一段 JS 顺便托管了评论系统。

dimlau

2016-03-08 11:25:54 +08:00

/t/55473

88250

2016-03-08 11:45:04 +08:00

@dimlau 完全不一样的思路。

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

文章也是使用同样的方式来进行聚合、互连。博主不用担心第三方服务集成带来的问题（比如网络限制、数据丢失等），并且可以让自己的文章通过在社区聚合从而带来更多的关注和评论。

dimlau

2016-03-09 11:39:27 +08:00

@88250 我是说，用一段 JS 也可以做到把 blog 文章推送到社区去。至于评论……
是的是的，思路不同。各有利弊。

88250

2016-03-09 11:43:34 +08:00

@dimlau 我懂你的意思了，无论如何，多谢你的反馈啦~

88250

2016-03-11 18:05:32 +08:00

@DT27 你提供的插件我附言了，辛苦了！

DT27

2016-03-11 20:03:10 +08:00

@88250 嘿嘿，边学边做的~

88250

2016-03-12 20:15:47 +08:00

@zonghua @zsx

辛苦啦~

88250

2016-03-12 20:18:40 +08:00

目前一共有三款博客提供了插件：

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

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

欢迎大家接入自己的博客到黑客派社区中，也欢迎大家提供更多的接入插件！

zonghua

2016-03-13 01:16:43 +08:00 via iPhone

javascript 前端的插件可以怎么实现？像那些第三方评论系统

RqPS6rhmP3Nyn3Tm

2016-03-13 14:24:40 +08:00

Ghost 没有插件系统，只能直接插 JS
如果能和 Disqus 整合就更好了

88250

2016-03-14 10:01:27 +08:00

@BXIA JS 版的 SDK 稍后推出~

hiroya

2016-03-16 13:04:43 +08:00 via iPad

求个 hexo 的插件～

hobbyliu

2016-04-06 18:19:50 +08:00 via Android

v2ex 啥时候支持？

Showfom

2016-04-06 19:50:52 +08:00

看到 Solo 就想到了那个啥。。。。

88250

2016-04-06 22:38:45 +08:00

@Showfom 要 LOL 还是 DoTA ？ 23333

@hobbyliu 什么意思呢？

Showfom

2016-04-06 22:50:05 +08:00

@88250 不不不 Solo 是自 0.0 慰的意思

88250

2016-04-06 23:39:57 +08:00

@Showfom 这个解，让我想起了。

解：

算了....

aitaii

2016-04-08 12:40:02 +08:00

不知道为什么看到把 b 和 3 连在一起看到我浑身难受。。。（逃。。。