如何使用Postman向Timekit API发送请求？新手API入门求助

嘿，我明白你刚接触API，想先通过Postman摸透Timekit.io的Find Time接口用法，之后再用到JS项目里～我来给你一步步拆解怎么弄，两种方法都给你说清楚：

方法一：直接导入Curl命令（最快上手） #

Postman支持直接导入curl命令，省去手动配置的麻烦：

• 打开Postman，点击左上角的「Import」按钮
• 在弹出的导入窗口里，选择「Raw text」选项卡
• 把你拿到的完整curl命令粘贴进去：

curl --request POST \
  --url https://api.timekit.io/v2/findtime \
  --header 'Content-Type: application/json' \
  --user :live_api_key_7nzvc7ws...

• 点击「Import」，Postman会自动帮你配置好请求方法、URL、请求头和认证信息，直接就能测试！

方法二：手动配置请求（更懂原理） #

如果想搞清楚每个配置项的作用，手动搭建请求是个好办法：

1. 新建空白请求：点击Postman左上角的「+」号，创建一个新请求
2. 设置请求核心信息：
   • 把请求方法从默认的GET改成POST（下拉菜单里选就行）
   • 在URL输入框中填入：https://api.timekit.io/v2/findtime
3. 配置请求头：
   • 切换到「Headers」标签页
   • 添加一条请求头：
     • Key：Content-Type
     • Value：application/json
4. 设置认证（关键！）：
   • 切换到「Authorization」标签页
   • 认证类型选择「Basic Auth」
   • Timekit的API认证规则是空用户名+API密钥作为密码，所以：
     • Username：留空不填
     • Password：填入你的完整live_api_key_7nzvc7ws...（把省略号替换成实际的密钥内容）
5. 添加请求体（必填参数）：
   • 切换到「Body」标签页，选择「raw」格式，然后把右侧的格式切换为「JSON」
   • 你需要根据Timekit的文档填写查找时间的具体参数，比如目标资源、时间范围、会议时长等，举个基础示例：

     {
       "resources": ["your-resource-calendar-id"],
       "start": "2024-10-01T09:00:00Z",
       "end": "2024-10-07T17:00:00Z",
       "duration": 3600
     }
     

   • 记得把your-resource-calendar-id替换成你实际的资源ID，参数要符合Timekit文档的要求哦

新手避坑小贴士 #

• 测试前确认你的API密钥是有效的，Timekit的live密钥需要从官方控制台获取
• 如果请求返回错误，先看响应体里的错误提示，大概率是参数格式不对或者认证信息有误
• 等Postman里请求测试成功后，再把逻辑迁移到JS应用里，比如用fetch或者axios库来发送POST请求，参数和认证规则和Postman里是一致的

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