集成到 Bit.ly API 版本 4 - 如何生成 OAuth2 令牌以与 Bit.ly API V4 集成并创建缩短的 url？

Posted 2023-03-08

【中文标题】集成到 Bit.ly API 版本 4 - 如何生成 OAuth2 令牌以与 Bit.ly API V4 集成并创建缩短的 url？

【英文标题】：Integrate to Bit.ly API Version 4 - How to Generate OAuth2 Token to integrate with Bit.ly API V4 and create a shortened url?

【发布时间】：2020-04-13 07:53:35

【问题描述】：

我在尝试生成 OAuth2 令牌 以与 Bitly API v4 集成时遇到了困难。他们的文档很难理解，我在网上或 *** 上找不到太多关于如何完成它的信息。我能够让它工作，并想与其他任何人在未来摸不着头脑的人分享解决方案。

以下是生成通用访问令牌、检索Group Guid的分步指南，生成 OAuth2 令牌，并调用 Bitly shorten API 请求。

【参考方案1】：

Bitly API- 获取 oAuth2 访问令牌 并使用 shorten 请求使用 检索 Tiny Url 的步骤邮递员：

花了大半天的时间试图弄清楚这一点后，我想我会发布这个，以便它可以帮助尝试与 Bitly API V4 集成的人。

注意： Bitly API V3 将于 2020 年 3 月 1 日停用，因此请务必尽快迁移到 V4。出于隐私考虑，响应中的所有 guid 和其他私有字段都已更改。

点击此链接参考Bitly API Documentation

1.) 生成访问令牌：

使用您的凭据登录 bitly.com，然后单击右上角的汉堡菜单。点击您的用户名，然后点击通用访问令牌。此通用访问令牌是检索您的Group Guid所必需的。您将需要此组指南连同您的访问令牌一起提出缩短 URL 请求。

2.) 检索组指导：

向 https://api-ssl.bitly.com/v4/groups 发出 GET 请求以获取您的 group_guid。 您将在授权字段中使用您的通用访问令牌。

下图是标题的外观：

您应该得到一个类似于下面的 JSON 的 JSON 响应：

检索组 Guid GET 响应的 JSON 响应：

    "groups": [
        
            "created": "2019-12-18T13:45:21+0000",
            "modified": "2019-12-18T13:45:21+0000",
            "bsds": [],
            "guid": "XZXUYSJAJ43", 
            "organization_guid": "JsjFtE841883",
            "name": "username",
            "is_active": true,
            "role": "org-admin",
            "references": 
                "organization": "https://api-ssl.bitly.com/v4/organizations/JsjFtE841883"
            
        
    ]

您的 guid 值是您在缩短和其他请求中使用的 group_guid。

3.) 检索您的 client_id 和 client_secret

使用您的用户凭据登录 bitly.com 来注册您的应用程序，您的应用程序将被分配一个 client_id 和一个 client_secret。您可以通过点击页面右侧的汉堡菜单来完成此操作，点击您的用户名、注册的 OAuth 应用程序，然后在底部它们应该是一个按钮，上面写着 注册新应用。

4.) 生成 OAuth2 访问令牌

请参阅Bitly Documentation 并在“身份验证”选项卡下导航至“交换用户名和密码以获得访问令牌”。

• 打开邮递员

• 向https://api-ssl.bitly.com/oauth/access_token 创建一个新的POST 请求。

• 复制 Curl 命令，但将用户名替换为 Bitly 登录用户名，密码替换为您的 Bitly 登录密码。

• 单击“导入”选项卡并选择“过去的原始文本”并粘贴到 curl 命令上

• 在“授权”选项卡中，将您的 client_id 粘贴到 用户名 字段和 client_secret 进入 密码 字段。这将为您执行 base64encoding。

• 您的标头只需要 Host 和 Content-Type 键和值。您的 Authorization 将是一个临时的标头字段，会自动为您生成。

• 您的身体需求：

grant_type：password（实际密码）

用户名：您在 bitly.com 的用户名

密码：bitly.com 的密码

下面是你的身体应该是什么样子的图片：

• 点击发送，您将收到您的访问令牌。

5.) 缩短网址

• 在 Postman 中打开新标签并向 https://api-ssl.bitly.com/v4/shorten 发出 Post 请求

• 标题应包括：

• 主机：api-ssl.bitly.com

• 授权：Bearer（您在步骤 4 中的访问令牌）

• 内容类型：应用程序/json

• 您的 正文 应包含以下 JSON：

  "long_url": "http://twitter.com",
  "group_guid": "guid field from Group Guid Response in Step 2"

• 点击发送，您应该会看到收到这样的 JSON 响应：

    "created_at": "2019-12-18T21:50:47+0000",
    "id": "yhoo/2PYRS",
    "link": "http://yhoo/2PYRS",
    "custom_bitlinks": [],
    "long_url": "http://yahoo.com/",
    "archived": false,
    "tags": [],
    "deeplinks": [],
    "references": 
        "group": "https://api-ssl.bitly.com/v4/groups/yourgroupguid"
    

JSON 响应中的 link 值将是您的新 Tiny URL 链接。

【讨论】：

非常感谢您提供这个详细的解决方案。自从 V3 被停用以来，我一直在到处寻找可靠的文档以迁移到 Bitly API V4。在这里我终于找到了。

@brasfan 我很高兴它有帮助！希望它也对其他人有所帮助。如果它对你有帮助，请点赞。