Skip to main content
本指南面向单公司账户的搭建。对于面向多用户的 Business 和 Enterprise 套餐订阅,我们会为你提供专门定制的集成指南。

连接你的社交媒体账户

登录或注册一个 Ayrshare 账户。 在 Social Account 页面上,点击你想要连接的社交网络。 请确保授予全部权限。

Facebook Linking Example

获取你的 API 密钥

访问 API 端点需要 API 密钥进行授权。 该密钥用于请求的请求头,并需要以 Bearer 关键字为前缀。 你的 API 密钥位于 Ayrshare 控制台 的 API Key 页面。如有必要,请先在 User Profiles 页面切换到「Primary Profile」(主配置文件)。 然后你可以在左侧面板中找到 API Key 页面。 API Key 每次 API 调用都必须在请求头中通过 Bearer 令牌携带 API 密钥。同时还要包含 Content-Type: application/json。
Header
更多信息请参见 Authorization。

发送你的第一次 API 发帖

发布帖子

以下是使用我们的 API 在不同编程语言中进行发帖的代码示例。 若想更轻松地集成,你还可以使用我们预先构建好的 SDK 包。 要发帖,你需要:
  • 用于身份认证的 API 密钥。
  • 帖子的文本内容。
  • 你希望发布到的社交媒体平台(仅包含你已关联的平台)。
  • 可选:你希望附带的图片或视频 URL。
所有示例都使用 /post 端点。让我们看几段示例代码:
要发布到 X/Twitter? X 需要你自己的 API 凭据。请在请求中添加两个 BYO 请求头(X-Twitter-OAuth1-Api-Key 和 X-Twitter-OAuth1-Api-Secret)。这是 每个 Ayrshare 账户的一次性设置,同一对密钥适用于每一个子配置文件 / 终端用户。详细步骤请参见 设置指南。
恭喜!你已成功发送第一条帖子。

发帖响应

当我们的 API 成功处理你的发帖时,你会收到一个 status 为 “success” 的响应。响应中包含:
  • status:API 调用的整体状态(“success” 或 “error”)
  • errors:遇到的错误数组(成功时为空)
  • postIds:包含各平台具体信息的对象数组:
    • 平台名称
    • 该平台上的帖子 ID
    • 查看该帖子的 URL
    • 其他平台特有的信息
postIds 数组中每个平台都会有自己的状态,让你可以确认哪些平台成功接收了你的帖子。 请检查你的社交媒体页面,确认帖子已成功处理并正常展示。请注意,一些平台在帖子公开显示前可能会有轻微延迟。 以下是一个示例响应:
Post Response
查看更多在 Node.js、Python、PHP、Go、C# 和 Ruby 中调用社交媒体 API 的代码示例,以及其他优秀功能:

Post

深入了解一下

让我们拆解一下刚才发起这次 API 调用时到底发生了什么。
1

设置请求头

我们设置了请求头的 Authorization Bearer 令牌(API 密钥)以及 Content-Type 为 json。
2

构造 Body 对象

然后,我们构造了 Body 对象:
  • 包含文本 “Today is a great day!” 的 post。
  • 社交网络平台为 Facebook、Instagram 和 LinkedIn。 你只应包含在 Social Linkage 页面上关联过的平台。
  • 在 mediaUrls 中添加了一张图片。
3

调用 /post 端点

将上述内容作为 HTTP POST 请求发送到 /post 端点。

在你继续之前,一些最佳实践

阅读文档

我们维护着大量、持续更新的文档。既然你已经在这里了,就花点时间浏览一下左侧导航中的各个部分吧。

错误码很重要

你需要处理它们,才能给用户带来良好的体验。

错误

妥善保管你的 API 密钥

我们对安全极其重视,你也应该如此。你完全掌握 Ayrshare 与你社交媒体账户之间的连接。一旦账户完成连接,Ayrshare API 密钥就是你进行身份认证的凭证。请务必将该密钥保密并妥善保存。

发布测试帖子

你可以在 /post 端点 中使用 randomPost、randomMediaUrl,以及 isLandscapeVideo 或 isPortraitVideo 参数发布带有随机引言、图片或视频的测试帖子。如果使用了 randomPost,则不再需要 post 参数。
这些帖子会真实发布到你的社交媒体页面上,测试完成后如有需要请及时删除。

随机引言

添加 randomPost: true 即可发送一条随机引言,用于测试发帖。 用于 /post 端点。

随机图片

添加 randomMediaUrl: true 即可发送一张随机图片。 用于 /post 端点。

随机视频

添加 isVideo: true 和 isLandscapeVideo: true 即可发送一段随机横向视频。 视频将采用标准横向尺寸。 用于 /post 端点。
添加 isVideo: true 和 isPortraitVideo: true 即可发送一段随机竖向视频,适用于 TikTok 或 Facebook/Instagram Reels。 用于 /post 端点。

随机评论

添加 randomComment: true 即可发送一条随机评论,用于测试发布评论。 用于 /comment 端点。

cURL 调用示例

发送一条随机引言与竖向视频。

使用 Postman 测试 API 调用

Postman 是一款出色的 API 调用测试工具。你甚至可以用它生成十几种语言的代码。

示例代码

如果你想找基于 React 和 Node.js 的示例项目,请查看这个 GitHub 仓库:

Github 社交发帖示例应用

常见问题排查

有时事情不会一帆风顺,我们的帮助中心提供了一些排查建议。

故障排查

联系我们寻求帮助

我们随时准备帮忙,请使用右下角的聊天功能,或者发邮件给我们。