使用 postman 测试思源笔记接口

思源笔记 API 权鉴

官方文档-中文:https://github.com/siyuan-note/siyuan/blob/master/API_zh_CN.md

权鉴相关介绍截图:

对应的xxx,在软件中查看

如上图:在每次发送 API 请求时,需要在 Header 中添加 以下键值对:

这种权鉴 Header 有别于规范的 Header,是一种特殊的定制化的 Header(和 Bearer token 有点像,但是 Bearer token 使用的标识符是 Bearer 而不是 Token)。使用 Postman 进行接口测试时,无法使用现成的权鉴方式

解决方法:

Postman 支持强大的脚本功能,可在请求执行前后执行自定义脚本
因此可以在整个 collection 中编写自定义脚本,自定义脚本中拼接需要的权鉴键值对

  • 创建环境变量,变量名为siyuan_token

  • 为整个 Collection 创建全局脚本

    选择整个 collection (我这里建的名称为 siyuan),找到 Script -- Pre-request (脚本 -- 请求前脚本)
    添加以下代码 参考文档:https://blog.csdn.net/qq_31521561/article/details/134915534

    javascript 复制代码
    // 从环境变量中获取 token (XXX)
    const token_raw = pm.environment.get("siyuan-token");
    
    // 向 Header 中手动添加字段:Authorization: Token XXX
    pm.request.headers.add({
        key:"Authorization",
        value:"Token ".concat(token_raw)
    })
  • collection 中的具体 API,权鉴方式都采用"继承上级文档的设置"

测试,查看请求发送的具体结果

可看到接口发送的 Header 中有刚才拼接的Authorization: Token XXX相关的字段,且成功返回值

相关推荐
天水幼麟3 小时前
动手学深度学习-学习笔记(总)
笔记·深度学习·学习
Small black human5 小时前
HTTP-Postman的安装及其使用
测试工具·postman
天水幼麟5 小时前
动手学深度学习-学习笔记【二】(基础知识)
笔记·深度学习·学习
绿皮的猪猪侠6 小时前
算法笔记上机训练实战指南刷题
笔记·算法·pta·上机·浙大
沧海一笑-dj6 小时前
【51单片机】51单片机学习笔记-课程简介
笔记·学习·51单片机·江科大·江科大学习笔记·江科大单片机·江科大51单片机
老虎06276 小时前
JavaWeb(苍穹外卖)--学习笔记04(前端:HTML,CSS,JavaScript)
前端·javascript·css·笔记·学习·html
大苏打seven7 小时前
Docker学习笔记:Docker网络
笔记·学习·docker
AIZHINAN8 小时前
Appium 简介
自动化测试·测试工具·appium
kikikidult11 小时前
(2025.07)解决——ubuntu20.04系统开机黑屏,左上角光标闪烁
笔记·ubuntu
近津薪荼11 小时前
初学者关于数据在内存中的储存的笔记
笔记