社区 API 接口文档

为了方便程序员们发布内容，我们开发了一些 API， 这篇文章是社区 API 接口的说明。 我们还提供了测试服务器，以便在正式服务器上发布内容之前进行测试。

申请Api Key

在使用 API 接口前，需要先申请 Api Key。

如何申请Api Key

• 测试服：请联系 Tiny 熊 或者晓娜

• 正式服： 登录网站后，进入 Api Key 页面，点击生成。如下图所示：

  

接口详情

API 接口地址：

• 正式服：https://learnblockchain.cn/api
• 测试服：http://123.88.4.114:8088/api

获取自己的文章列表

接口

get/user/{id / handle }/articles

请求Header参数

请求示例：

import requests

url = "https://learnblockchain.cn/api/get/user/{your_handle_or_user_id}/articles"
headers = {"x-api-key": " your api _ key"}
response = requests.request("GET", url, headers=headers)

print(response.text)

返回结果示例：

{
    "code": 0,
    "message": "获取成功!",
    "articles": [
        {
            "title": "xxxxx",
            "link": "url....",
            "supports": 2,
            "views": 100,
            "created_time": "2025-03-05 17:03",
            "update_time": "2025-03-06 15:57"
        },

            ],
    "user": {
        "id": "tiny",
        "name": "Tiny熊",
        "avatar": "...",
        "twitter": "...."
    }
}

获取文章详情

接口

get/article/{article_id}

请求Header参数

请求示例：

import requests

url = "https://learnblockchain.cn/api/get/article/{article_id}"
headers = {"x-api-key": " your api _ key"}
response = requests.request("GET", url, headers=headers)

print(response.text)

返回：

{
    "code": 0,
    "message": "获取成功!",
    "article_data": {
        "id": 100x,
        "title": "ZK 邮件 确保电子邮件隐私的零知识证明",
        "summary": " ...",
        "content": "...",
                "views": 141,
        "created_time": "2025-03-15 11:59",
        "update_time": "2025-03-15 12:06"
    },
    "user_data": {
        "id": "user_handle",
        "name": "name",
        "avatar": "..."
    }

文章发布接口

接口

/post/article

请求方式：POST

请求Header参数

请求Body参数

请求示例代码

curl --request POST \
  --url https://learnblockchain.cn/api/post/article \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'content-type: application/x-www-form-urlencoded' \
  --header 'x-api-key: ' \
  --data 'title=每周以太坊进展' \
  --data 'content=正文内容...' \
  --data 'summary=摘要内容...' \
  --data 'price=10' \
  --data 'logo= https://img.zcool.cn/community/01c94c563736d66ac7259e0fd89fcb.jpg@2o.jpg' \
  --data 'type= 3' \
  --data link=https://learnblockchain.cn/article/5722 \
  --data 'is_public=1' \
  --data 'category_id=7'

成功响应示例

{
    "code": 0,
    "message": "文章发布成功!"
}

错误响应示例

{
    "code": -1006,
    "message": "文章发布失败, 请稍后再试...!"
}

文章发布成功后可在文章页面（正式服， 测试服）查看

招聘发布接口

接口

/post/recruit

请求方式: POST

请求Header参数

请求Body参数

请求示例代码

curl --request POST \
  --url https://learnblockchain.cn/api/post/recruit \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'x-api-key: ' \
  --data 'name=合约开发工程师' \
  --data 'content=主要负责项目合约开发...' \
  --data 'types=全职' \
  --data 'work_year=1~3年' \
  --data 'education=本科' \
  --data 'salary=10~20K' \
  --data 'address=上海市浦东新区'\
  --data 'project_description=xx公司, xx团队, 联系电话...'

成功响应示例

{
    "code": 0,
    "message": "招聘信息发布成功!"
}

错误响应示例

{
    "code": -1005,
    "message": "招聘信息发布失败, 请稍后再试...!"
}

招聘发布成功后可在招聘页面（正式服， 测试服）查看