Mixpost 技能

Mixpost 是一款自托管的社交媒体管理软件，可帮助您在多个平台（包括 Facebook、Twitter/X、Instagram、LinkedIn、Pinterest、TikTok、YouTube、Mastodon、Google Business Profile、Threads、Bluesky 等）上安排和管理社交媒体内容。

设置

1. 1. 导航至您的 Mixpost 仪表盘
2. 从用户菜单中点击 访问令牌
3. 点击 创建 以生成新令牌
4. 获取您的工作区 UUID：前往 社交账户 页面，点击任意账户上的 三点菜单，然后复制工作区 UUID
5. 设置环境变量：

测试连接

bash
curl -X GET $MIXPOST_URL/api/ping \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

账户

获取所有账户

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/accounts \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

获取特定账户

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/accounts/:accountUuid \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

媒体

获取所有媒体

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/media?limit=50 \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

获取特定媒体文件

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/media/:mediaUuid \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

上传媒体（表单数据）

bash
curl -X POST $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/media \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json \
-F file=@/path/to/your/file.png

更新媒体

bash
curl -X PUT $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/media/:mediaUuid \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Content-Type: application/json \
-H Accept: application/json \
-d {
alt_text: 用于无障碍访问的替代文本
}

删除媒体

bash
curl -X DELETE $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/media \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Content-Type: application/json \
-H Accept: application/json \
-d {
items: [media-id-1, media-id-2]
}

标签

获取所有标签

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/tags \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

获取特定标签

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/tags/:tagUuid \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

创建标签

bash
curl -X POST $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/tags \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Content-Type: application/json \
-H Accept: application/json \
-d {
name: 市场营销,
hex_color: #FF5733
}

更新标签

bash
curl -X PUT $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/tags/:tagUuid \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Content-Type: application/json \
-H Accept: application/json \
-d {
name: 更新后的标签名称,
hex_color: #00FF00
}

删除标签

bash
curl -X DELETE $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/tags/:tagUuid \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

帖子

获取所有帖子

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/posts?limit=50&status=scheduled&page=1 \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

查询参数：

• - limit（数字，默认值：50）：每页结果数
• status：draft（草稿）、scheduled（已安排）、published（已发布）、failed（失败）、needs_approval（待审批）、trash（回收站）
• keyword（字符串）：按内容搜索帖子
• accounts（数组）：按账户 ID 筛选
• tags（数组）：按标签名称筛选
• page（数字）：分页页码

获取特定帖子

bash
curl -X GET $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/posts/:postUuid \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Accept: application/json

创建帖子

bash
curl -X POST $MIXPOSTURL/api/$MIXPOSTWORKSPACE_UUID/posts \
-H Authorization: Bearer $MIXPOSTACCESSTOKEN \
-H Content-Type: application/json \
-H Accept: application/json \
-d {
schedule: true,
date: 2024-12-25,
time: 10:00,
timezone: America/New_York,
accounts: [1, 2],
tags: [1],
versions: [
{
account_id: 0,
is_original: true,
content: [
{
body: 来自 Mixpost API 的问候！,
media: [1, 2],
url: https://example.com
}
],
options: {}
}
]
}

帖子选项：

• - schedule：设置为 true 以安排到特定日期/时间
• schedule_now：设置为 true 以立即发布
• queue：设置为 true 以添加到发布队列
• 如果均未设置，帖子将保存为草稿

平台特定选项：
json
{
options: {
facebook_page: {
type: post // post（帖子）、reel（短视频）、story（故事）
},
instagram: {
type: post // post（帖子）、reel（短视频）、story（故事）
},
linkedin: {
visibility: PUBLIC // PUBLIC（公开）、CONNECTIONS（仅好友）
},
mastodon: {
sensitive: false // 布尔值
},
pinterest: {
link: null, // null | 字符串
title: , // 字符串
boards: {
account-1: 971672010430333260 // 键 account-* 是您 Pinterest 账户的 ID
}
},
youtube: {
title: null, // null | 字符串
status: public // public（公开）、private（私密）、unlisted（不公开列出）
},
gbp: { // Google Business Profile
type: post, // post（帖子）、offer（优惠）、event（活动）
button: NONE, // NONE（无）、BOOK（预订）、ORDER（