跳转到主要内容

第一步:注册开发者账户

注册开发者账户既快捷又简单!只需点击下方按钮,回答几个问题,即可通过基础权限开始探索并基于 X API v2 开发。 接下来,你将在入门流程中创建一个项目(Project)和关联的开发者应用(App),系统会向你提供一组凭证,用于对所有发送到 API 的请求进行认证。 注册

步骤二:保存你的应用密钥和令牌并确保其安全

在你获得访问权限并创建项目与应用后,你可以在开发者应用中查找或生成以下凭证:
  • API Key 和 Secret 本质上是你的应用的“用户名”和“密码”。你将使用它们来为需要 OAuth 1.0a 用户上下文 的请求进行认证,或生成其他令牌,例如用户 Access Token 或 App Access Token。
  • Access Token 和 Secret 一般而言,Access Token 代表你所代用户发起请求的身份。你通过开发者门户生成的令牌代表拥有该应用的用户。你将使用这些令牌来为需要 OAuth 1.0a 用户上下文 的请求进行认证。若需代表其他用户发起请求,你需要使用三方 OAuth 流程以获取其授权。
  • Client ID 和 Client Secret 这些凭证用于通过 OAuth 2.0 认证获取用户 Access Token。与 OAuth 1.0a 类似,用户 Access Token 用于对提供私密用户账户信息或代表其他账户执行操作的请求进行认证,但具备更细粒度的权限范围,从而更好地控制客户端应用对用户的访问。
  • 仅应用 Access Token 当你向返回 X 上公开可用信息的端点发起请求时,将使用此令牌。
由于这些密钥和令牌除非被重新生成否则不会过期,我们建议在收到凭证后,将它们保存在安全位置,例如密码管理器。
请注意:你的密钥和令牌只会在开发者门户中显示一次,因此在生成后务必立即将这些凭证存入你的密码管理系统。 如果你丢失或忘记了这些密钥和令牌,你需要重新生成它们,这将创建新的凭证并使旧的凭证失效。这意味着你必须更新使用先前凭证配置的任何集成。 了解更多我们的认证最佳实践

第三步:发起首个请求

下一步是什么?让我们向 API 发起你的第一个请求! 我们提供指南、教程、工具和示例代码,帮助你上手。以下页面是理想的起点,但请注意,我们还整理了“重要资源”页面,便于你查阅更全面的文档。 发起你的第一个请求

下一步

通过我们的 API 参考索引找到一个端点,开始上手。 我们还提供一套 X API 的工具与库,可帮助你更高效地完成集成。