教程
Postman 入门指南
相关产品
简介
Postman 是一个 REST 客户端，可实现在用户界面内向 API 发出请求。当我们使用新的端点时，这很有帮助。若要开始使用 Postman，你首先需要申请一个 Twitter 开发者账号。账号获得批准后，你需要创建一个应用。
在此示例中，你将使用 Twitter 开发者实验室的推文和用户预览版。你需要首先在实验室注册并将创建的应用附加到此预览版中。你还需要使用刚创建的凭据创建不记名的令牌。
使用 Postman
首先，需要下载 Postman。你可以下载实验室的 Postman 推文集来帮助你以更快的速度启动和运行。下载推文集之后，可以修改 Tweets and Users v2 文件夹中的推文和用户示例。选择名为 GET Single user by username 的示例。
你需要调整路径变量以包含要查找的用户名。显示 Path Variables 时，更改该值以包含要查看其有效负载的 Twitter 用户名。此示例使用用户名 TwitterDev。
结果应如下所示：
你需要先调整身份验证设置，然后才能按蓝色发送按钮。如果点击显示 Authorization 的选项卡，则需要在“类型”下方选择 Bearer Token。你可以将创建的不记名令牌添加到 Token 一词旁边的框中。
需要键入的完整地址为：
https://api.twitter.com/labs/2/users/by/username/:username
添加不记名令牌后，通过按显示 send 的蓝色按钮提交请求。
现在，你应看到类似于以下有效负载的内容：
{
"data": {
"id": "2244994945",
"name": "Twitter Dev",
"username": "TwitterDev"
}
}
你可以在请求中添加一个扩展，以实现在单个响应中请求其他引用对象及其字段。在显示 Query Params 的位置下方，你可能需要选中 expansions 一词旁边的框，并在 Params 文件夹中 value 一词的下方键入 pinned_tweet_id。
现在，你可以按“发送”按钮，以获取如下所示的有效负载：
{
"data": {
"id": "2244994945",
"name": "Twitter Dev",
"pinned_tweet_id": "1214281000932593667",
"username": "TwitterDev"
},
"includes": {
"tweets": [
{
"id": "1214281000932593667",
"text": "Hello… is it me you’re searching for? 🔎\n\nSearch the conversation as it unfolds with this new addition to Labs. We're making it easier than ever to find the Tweets you care about. https://t.co/HmuuUC6PKZ https://t.co/QgEXeL9XzX"
}
]
}
}
了解更多关于推文的信息
现在你已发出了前几个请求。恭喜！
要发出后续请求，你需要使用 GET Tweets 了解更多关于 TwitterDev 最新发出的推文的信息。若要进行设置，你需要点击之前使用的文件夹中标题为 GET Tweets 的示例请求。
你首先需要像之前那样修改 URL，方式是选中 Params 文件夹中显示 Path Variables 的位置下方的框。在上一个示例中，通过查看 JSON "pinned_tweet_id": "1214281000932593667". 中的键值对，你可以看到最新的推文 ID 为 1175170649968349184
通过 fields 参数可以指定使用实验室 v2 端点在 API 响应中返回哪些其他数据字段。我们需要选择标题为 tweet.fields 的框，并在 value 一词下方键入以下内容：
attachments,author_id,created_at,entities,geo,id,in_reply_to_user_id,lang,possibly_sensitive,public_metrics,referenced_tweets,source,text,withheld
你还需要像在上一个请求中一样，使用之前在此过程中创建的同一不记名令牌更新身份验证设置。
做出更改之后，即可按蓝色发送按钮。完成此操作后，你应看到如下有效负载：
{
"data": {
"attachments": {
"media_keys": [
"16_1214280974223237120"
]
},
"author_id": "2244994945",
"created_at": "2020-01-06T20:22:05.000Z",
"entities": {
"urls": [
{
"start": 179,
"end": 202,
"url": "https://t.co/HmuuUC6PKZ",
"expanded_url": "https://twittercommunity.com/t/new-recent-search-endpoint-available-in-labs/133076",
"display_url": "twittercommunity.com/t/new-recent-s…"
},
{
"start": 203,
"end": 226,
"url": "https://t.co/QgEXeL9XzX",
"expanded_url": "https://twitter.com/TwitterDev/status/1214281000932593667/photo/1",
"display_url": "pic.twitter.com/QgEXeL9XzX"
}
]
},
"id": "1214281000932593667",
"lang": "en",
"possibly_sensitive": false,
"public_metrics": {
"retweet_count": 60,
"reply_count": 39,
"like_count": 149,
"quote_count": 13
},
"source": "Twitter Web App",
"text": "Hello… is it me you’re searching for? 🔎\n\nSearch the conversation as it unfolds with this new addition to Labs. We're making it easier than ever to find the Tweets you care about. https://t.co/HmuuUC6PKZ https://t.co/QgEXeL9XzX"
}
后续操作
如果点击 Postman 中显示代码的按钮，你可以将我们刚创建的请求转换为所选的语言（如 Python、Node 或 Ruby），以帮助你入门。Postman 提供了出色的文档，可能对你有所帮助。。你还可以查看 GitHub 上的示例代码。还请务必查看实验室相关文档以了解更多信息。
准备好构建你的解决方案了吗？