连接你的社交媒体账户
登录或注册一个 Ayrshare 账户。 在 Social Account 页面上,点击你想要连接的社交网络。 请确保授予全部权限。
获取你的 API 密钥
访问 API 端点需要 API 密钥进行授权。 该密钥用于请求的请求头,并需要以Bearer 关键字为前缀。
你的 API 密钥位于 Ayrshare 控制台 的 API Key 页面。如有必要,请先在 User Profiles 页面切换到「Primary Profile」(主配置文件)。
然后你可以在左侧面板中找到 API Key 页面。

Bearer 令牌携带 API 密钥。同时还要包含 Content-Type: application/json。
Header
发送你的第一次 API 发帖
发布帖子
以下是使用我们的 API 在不同编程语言中进行发帖的代码示例。 若想更轻松地集成,你还可以使用我们预先构建好的 SDK 包。 要发帖,你需要:- 用于身份认证的 API 密钥。
- 帖子的文本内容。
- 你希望发布到的社交媒体平台(仅包含你已关联的平台)。
- 可选:你希望附带的图片或视频 URL。
要发布到 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
Post
深入了解一下
让我们拆解一下刚才发起这次 API 调用时到底发生了什么。构造 Body 对象
然后,我们构造了 Body 对象:
- 包含文本 “Today is a great day!” 的 post。
- 社交网络平台为 Facebook、Instagram 和 LinkedIn。 你只应包含在 Social Linkage 页面上关联过的平台。
- 在 mediaUrls 中添加了一张图片。
在你继续之前,一些最佳实践
阅读文档
我们维护着大量、持续更新的文档。既然你已经在这里了,就花点时间浏览一下左侧导航中的各个部分吧。错误码很重要
你需要处理它们,才能给用户带来良好的体验。错误
妥善保管你的 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 端点。
