Node.js调用Clockify API POST请求提示身份认证错误如何解决

错误根因 #

• axios.post的参数传递逻辑存在语法错误，官方标准调用规则为axios.post(url[, 请求体数据[, 配置对象]])，第二个参数直接传入接口需要的请求体内容，第三个参数才是放置headers、超时配置等的配置项。
• 你将请求体数据和headers配置全部放在了第二个参数的位置，导致X-Api-Key请求头没有被axios正确附加到请求中，Clockify服务端无法读取到认证信息，因此返回权限不足报错。你之前调用get接口正常是因为axios.get的语法为axios.get(url[, 配置对象])，第二个参数直接放配置对象即可，和post的参数逻辑存在差异。

修复后代码 #

async function addNewClient(clientName) {
  try {
    const response = await axios.post(
      `${url}/workspaces/${workspaceId}/clients`,
      // 第二个参数直接放请求体，不需要额外包data字段
      {
        name: clientName
      },
      // 第三个参数放配置项，headers放在这里才会生效
      {
        headers: {
          'X-Api-Key': CLOCKIFY_API_KEY,
          'Content-Type': 'application/json',
        }
      }
    )
    return response
  } catch (error) {
    console.log(error.response?.data?.message || error.message)
    return
  }
}

额外校验项 #

如果修改后仍有问题可以逐一排查：

• 确认CLOCKIFY_API_KEY变量取值正常，无拼写错误、未定义、空值等问题
• 确认当前API密钥对应账号对目标工作区有创建客户的写入权限，部分只读权限的密钥仅支持调用查询类get接口，无法调用写入类post接口
• 确认url、workspaceId的取值和你调用正常的get接口时的取值完全一致

内容的提问来源于stack exchange，提问作者JorisH0