"状态 开发实现方面已经完成,正式发布! 如果你想开发客户端,请参考[链接] B3log 构思 [链接]目前已经基本实现, [链接]、[链接] 和[链接]已经可以进行帖子、回帖内容交互: 使用博客发布文章、评论会自动推送到黑客派社区 在黑客派社区上发布帖子、回帖也会自动推送到博客 这样可以为博主带来更多的关注和互动。 内 .."

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

点击展开正文内容

状态

B3log 构思

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

这样可以为博主带来更多的关注和互动。

内容 API

核心内容 API 一共有 4 个。前 2 个 API 由社区实现,提供给博客进行调用;后 2 个由博客实现,提供给社区进行调用:

  1. 博客发布 / 更新文章 -> 社区发布 / 更新帖子
  2. 博客发布评论 -> 社区发布回帖
  3. 社区发布 / 更新帖子 -> 博客发布 / 更新文章
  4. 社区发布回帖 -> 博客发布评论

账号关联

如果一切顺利,你的博客账号和社区账号就自动设置了相同的用户名和 B3 Key 了,然后再完成 B3 同步设置就完成关联账号了。

关联账号的核心要义就是用户名和 B3 Key 必须相同,因为后续的数据交互是通过用户名和 B3 Key 进行校验的。

API 规范

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

博客发布 / 更新文章推送社区

发布文章和更新文章使用相同的 API,如果 article.id 已经存在则视为更新操作。

调用地址

参数

在 POST body 中指定 JSON 格式的实参:

{
    "article": {
        "id": "1165070220000", 
        "title": "这是一篇测试文章", 
        "permalink": "/test-post", 
        "tags": "Sandbox", 
        "content": "上面请使用 Sandbox 作为标签。"
    }, 
    "client": {
        "title": "我的个人博客", 
        "host": "http://xxx.com", 
        "name": "Solo", 
        "ver": "3.0.0", 
        "userName": "88250", 
        "userB3Key": "xxxx"
    }
}

博客发布评论推送社区

调用地址

参数

在 POST body 中指定 JSON 格式的实参:

{
    "comment": {
        "id": "1165070220000", 
        "parentId": "", 
        "articleId": "1164070220000", 
        "content": "Test comment", 
        "authorName": ""
    }, 
    "client": {
        "title": "我的个人博客", 
        "host": "http://xxx.com", 
        "name": "Solo", 
        "ver": "3.0.0", 
        "userName": "88250", 
        "userB3Key": "xxxx"
    }
}

社区发布 / 更新帖子推送博客

接收文章的接口由博客实现,这里给出的是社区去调用时候的规范。

调用地址

参数

在 POST body 中指定 JSON 格式的实参:

{
    "article": {
        "id": "", 
        "title": "", 
        "content": "", 
        "contentHTML": "", 
        "tags": "tag1,tag2,tag3"
    }, 
    "client": {
        "userName": "", 
        "userB3Key": ""
    }
}

注意:从社区同步帖子到博客时,收文接口实现文章保存后不能再走同步回社区的逻辑。

社区发布回帖推送博客

接收评论的接口由博客实现,这里给出的是社区去调用时候的规范。

调用地址

参数

在 POST body 中指定 JSON 格式的实参:

{
    "comment": {
        "articleId": "", 
        "parentId": "",
        "content": "", 
        "contentHTML": "", 
        "authorName": "", 
        "authorURL": "", 
        "authorAvatarURL": "", 
        "isArticleAuthor": true, 
        "time": 1457784330398
    },
    "client": {
        "userName": "",
        "userB3Key": ""
    }
}

注意:从社区同步评论到博客时,收评接口实现评论保存后不能再走同步回社区的逻辑。

使用须知

从博客同步文章到社区请注意如下规则:

已接入的博客系统

  • 系统公告

    B3log 社区相关的重要公告,比如新特性上线,运营策略调整等。

    36 引用 • 3098 回帖 • 667 关注
  • Rhy
    1 引用 • 140 回帖
  • Sym

    Sym 是一个用 Java 实现的现代化社区(论坛 / 社交网络 / 博客)平台,“下一代的社区系统,为未来而构建”。黑客派就是使用该系统搭建的 ❤️

    381 引用 • 3945 回帖 • 645 关注
  • B3log

    B3log 是一个开源组织,名字来源于“Bulletin Board Blog”缩写,目标是将独立博客与论坛结合,形成一种新的网络社区体验,详细请看 B3log 构思。目前 B3log 已经开源了多款产品:PipeSoloSymWide 等,欢迎大家加入,贡献开源。

    2252 引用 • 3698 回帖 • 619 关注
感谢    关注    收藏    赞同    反对    举报    分享
136 回帖    
请输入回帖内容...
  • someone1101    

    同步回评论系统的时候不给 IP 和 User-Agent 合适吗?

       感谢    赞同    反对    举报    折叠    分享    评论    回复
  • 其他回帖
  • noah   1 感谢      

    想法不错

       感谢    赞同    反对    举报    折叠    分享    评论    回复
  • zempty   1 感谢      

    其实我想问,在初始化 solo 帐号的时候用的是一个邮箱,后期通过修改数据库换成另外的邮箱,是否设置同步就没效了?

       感谢    赞同    反对    举报    折叠    分享    评论    回复
  • 88250      

    @zempty 千万不要手动修改数据库…. 不然很多未知问题的

       感谢    赞同    反对    举报    折叠    分享    评论    回复
  • 查看更多回帖