跳转到主要内容
本指南面向单公司账户的搭建。对于面向多用户的 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-KeyX-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 端点 中使用 randomPostrandomMediaUrl,以及 isLandscapeVideoisPortraitVideo 参数发布带有随机引言、图片或视频的测试帖子。如果使用了 randomPost,则不再需要 post 参数。
这些帖子会真实发布到你的社交媒体页面上,测试完成后如有需要请及时删除。

随机引言

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

随机图片

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

随机视频

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

随机评论

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

cURL 调用示例

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

使用 Postman 测试 API 调用

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

示例代码

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

Github 社交发帖示例应用

常见问题排查

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

故障排查

联系我们寻求帮助

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