跳到主要内容
版本：2.20.0-SNAPSHOT

介绍

Halo 提供了 RESTful 风格的 API，Halo 的前端（主要为 Console 和 UC）与后端的交互都是通过 API 完成的。

此文档将介绍如何使用 Halo 提供的 RESTful API。

API 在线文档​

文档地址：https://api.halo.run

API 文档预览

其中，我们为 Halo 核心模块提供了几个分组，方便开发者查看：

  • Console API：为 Console 控制台提供的自定义 API。
  • User-center API：为 UC 个人中心提供的自定义 API。
  • Extension API：核心模型自动生成的 CRUD API。
  • Public API：公开的 API，无需认证。
  • Aggregated API：所有 API 的聚合。

认证方式​

个人令牌（推荐）​

个人令牌是一种用于访问 Halo API 的安全凭证，你可以使用个人令牌代替您的 Halo 账户密码进行身份验证。

在个人中心的个人令牌页面中，可以根据当前用户已有的权限创建个人令牌，创建方式可参考：个人中心 / 个人令牌

创建成功后，将会得到一个 pat_ 开头的字符串，接下来在所需请求的请求头中添加 Authorization 字段，值为 Bearer <pat> 即可。

示例​

cURL 请求示例：

curl -X 'GET' \
  'https://demo.halo.run/apis/content.halo.run/v1alpha1/posts' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer pat_1234567890abcdef'

Axios 请求示例：

import axios from 'axios';

axios.get('https://demo.halo.run/apis/content.halo.run/v1alpha1/posts', {
  headers: {
    Authorization: 'Bearer pat_1234567890abcdef',
  },
})
.then(response => {
  // handle response
})

Basic Auth​

注意

Basic Auth 认证方式已经在 Halo 2.20 默认关闭，需要手动添加 halo.security.basic-auth.disabled=false 启动参数来开启。

配置详情可见：配置列表

Basic Auth 是一种通过用户名和密码进行身份验证的方式，你可以使用 Halo 账户的用户名和密码进行身份验证。

在请求头中添加 Authorization 字段，值为 Basic <base64> 即可，其中 <base64> 为 username:password 的 Base64 编码。

示例​

cURL 请求示例：

curl -X 'GET' \
  'https://demo.halo.run/apis/content.halo.run/v1alpha1/posts' \
  -H 'accept: */*' \
  -H 'Authorization: Basic ZGVtbzpQQHNzdzByZDEyMy4u'

Axios 请求示例：

import axios from 'axios';

axios.get('https://demo.halo.run/apis/content.halo.run/v1alpha1/posts', {
  headers: {
    Authorization: `Basic ${Buffer.from('demo:P@ssw0rd123..').toString('base64')}`,
  },
})
.then(response => {
  // handle response
})

示例项目​

列举一些使用了 Halo RESTful API 的项目，以供参考：