Node.js SDK 接入教程：10 分钟调通第一个接口

用 Node.js 调用 YesApi 接口的完整教程：从安装、签名算法、发起请求到错误处理，附可运行示例代码。

最后更新：2026-07-20作者：YesApi Pro 团队 · 广州果创网络科技 SDK接入

核心结论：Node.js 接入 YesApi 三步走：①按「参数值排序拼接 + app_secret 后 MD5 大写」生成 sign；②POST 到 HOST/?s=服务名，带 s/app_key/sign；③判断返回 ret==200 再取 data。下方有 Node.js 完整示例代码。

⭐ 编辑推荐

想要自己的 API 平台？

YesApi Pro 私有部署后，用同样的 SDK 方式接入你自建的接口——源码交付、当天上线。

查看详情 →

一、准备与安装

Node.js 用内置 crypto 做 MD5、axios 发请求（form 编码）。

npm install axios qs

二、签名算法（核心）

YesApi 接口用签名（sign）防篡改，算法固定：把参数按 key 升序排序 → 拼接所有参数值（不含 key）→ 末尾追加 app_secret → MD5 → 转大写。各语言实现一致，务必与服务端保持相同规则。

const crypto = require('crypto');

// 签名：按 key 排序 → 拼接所有 value → 追加 app_secret → md5 → 大写
function yesapiSign(params, appSecret) {
  const str = Object.keys(params).sort().map(k => params[k]).join('');
  return crypto.createHash('md5').update(str + appSecret).digest('hex').toUpperCase();
}

三、发起第一个请求

请求方式为 POST，地址为 HOST/?s=服务名，参数用 form 表单编码，需带上 s、app_key 与计算好的 sign。下面是 Node.js 的完整可运行示例：

const axios = require('axios');
const qs = require('qs');

const HOST = 'http://your-domain.yesapi.cn/';
const APP_KEY = 'YOUR_APP_KEY';
const APP_SECRET = 'YOUR_APP_SECRET';
const SERVICE = 'App.Table.FreeQuery';

const params = { model_name: 'news', page: '1', perpage: '10' };
params.s = SERVICE;
params.app_key = APP_KEY;
params.sign = yesapiSign(params, APP_SECRET);

axios.post(HOST.replace(/\/$/, '') + '/?s=' + SERVICE, qs.stringify(params), {
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  timeout: 5000,
}).then(resp => console.log(resp.data));

四、返回结构与错误处理

YesApi 统一返回 JSON：ret 为状态码（200 成功），data 为业务数据，msg 为错误信息。务必判断 ret 再取数据：

// 返回：{ ret: 200, data: {...}, msg: '' }
if (resp.data.ret === 200) {
  const data = resp.data.data;      // 业务数据
} else {
  console.error('YesApi error:', resp.data.msg || '请求失败');
}