Twitter API v2集成实战：Twitter, together!开发指南

【免费下载链接】action:bird: A GitHub action to tweet from a repository项目地址: https://gitcode.com/gh_mirrors/act/action

Twitter, together! 是一款基于 GitHub Action 的强大工具，它能让你通过仓库协作的方式轻松实现 Twitter 自动发布功能。本文将为你提供一份完整的 Twitter API v2 集成开发指南，帮助你快速搭建属于自己的 Twitter 自动发布系统。

准备工作：创建 Twitter 开发者账号

要使用 Twitter API v2，首先需要创建一个 Twitter 开发者账号。访问 Twitter 开发者平台，按照提示完成账号申请。在申请过程中，你可能需要提供手机号和邮箱进行验证。对于"使用场景"，建议选择"制作机器人"；对于"是否向政府实体提供内容"，选择"否"即可。提交申请后，你将收到一封验证邮件，验证通过后即可开始创建应用。

创建 Twitter 应用并获取凭证

创建项目和应用

在 Twitter 开发者平台，首先需要创建一个项目。项目名称建议与 Twitter, together! 相关，以便日后识别。项目创建完成后，点击"Add App"按钮创建应用。应用名称需要全局唯一，建议使用类似"<你的 Twitter 账号名>-twitter-together"的格式。创建成功后，Twitter 会显示应用的 API Key 和 API Secret，请妥善保存这些信息。

配置应用权限

为了让应用能够发布推文，需要将其权限设置为"Read and write"。在应用设置中，找到"User authentication settings"部分，点击"Set up"。选择"Read and write"作为应用权限，"Web App, Automated App or Bot"作为应用类型。然后配置回调 URI 为"http://localhost"，网站 URL 为"https://github.com/twitter-together/action"，保存设置。

获取访问令牌

回到应用的"Keys and tokens"标签页，点击"Regenerate"按钮生成 Access Token 和 Access Token Secret。这些凭证将用于授权应用访问你的 Twitter 账号。将以下凭证保存到 GitHub 仓库的 Secrets 中：

创建 Twitter, together! 工作流

初始化工作流文件

在你的 GitHub 仓库中，打开"Actions"标签页，点击"Set up a workflow yourself"按钮。在文件名输入框中，将"main.yml"替换为"twitter-together.yml"。

编写工作流配置

在编辑器中，输入以下工作流配置代码：

on: [push, pull_request] name: Twitter, together! jobs: preview: name: Preview runs-on: ubuntu-latest if: github.event_name == 'pull_request' steps: - uses: twitter-together/action@v3 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} tweet: name: Tweet runs-on: ubuntu-latest if: github.event_name == 'push' && github.ref == 'refs/heads/main' steps: - name: checkout main uses: actions/checkout@v3 - name: Tweet uses: twitter-together/action@v3 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} TWITTER_ACCESS_TOKEN: ${{ secrets.TWITTER_ACCESS_TOKEN }} TWITTER_ACCESS_TOKEN_SECRET: ${{ secrets.TWITTER_ACCESS_TOKEN_SECRET }} TWITTER_API_KEY: ${{ secrets.TWITTER_API_KEY }} TWITTER_API_SECRET_KEY: ${{ secrets.TWITTER_API_SECRET_KEY }}

如果你的仓库默认分支不是"main"，请将代码中的"main"替换为你的默认分支名称。

提交工作流文件

点击"Start commit"按钮，输入提交信息（例如"setup twitter-together"），然后点击"Commit new file"按钮提交工作流文件。

克隆仓库并开始使用

要开始使用 Twitter, together!，首先需要克隆仓库：

git clone https://gitcode.com/gh_mirrors/act/action

克隆完成后，你可以在仓库的"tweets"目录下创建 tweet 文件。每个 tweet 文件对应一条推文，你可以通过 pull request 的方式提交推文，经审核后合并到主分支即可自动发布到 Twitter。

总结

通过本文的指南，你已经成功集成了 Twitter API v2 并搭建了 Twitter, together! 工作流。现在，你可以通过 GitHub 仓库协作的方式轻松管理和发布 Twitter 内容，提高团队协作效率。如果你想了解更多高级功能，可以查阅项目的官方文档和源码。

【免费下载链接】action:bird: A GitHub action to tweet from a repository项目地址: https://gitcode.com/gh_mirrors/act/action