Mixpost 技能

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

配置

1. 进入您的 Mixpost 仪表板
2. 从用户菜单中点击 Access Tokens
3. 点击 Create 生成一个新的访问令牌
4. 获取您的 workspace UUID：前往 Social Accounts 页面，点击任意账号右侧的 3 dots 菜单，并复制 workspace UUID
5. 设置环境变量：

   export MIXPOST_URL="https://your-mixpost-instance.com/mixpost"
   export MIXPOST_ACCESS_TOKEN="your-access-token"
   export MIXPOST_WORKSPACE_UUID="your-workspace-uuid"
   

测试连接

curl -X GET "$MIXPOST_URL/api/ping" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

账号

获取所有账号

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/accounts" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

获取指定账号

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/accounts/:accountUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

媒体

获取所有媒体文件

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media?limit=50" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

获取指定媒体文件

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media/:mediaUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

上传媒体（form-data）

curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json" 
  -F "file=@/path/to/your/file.png"

更新媒体信息

curl -X PUT "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media/:mediaUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "alt_text": "Alternative text for accessibility"
  }'

删除媒体文件

curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "items": ["media-id-1", "media-id-2"]
  }'

标签

获取所有标签

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

获取指定标签

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags/:tagUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

创建标签

curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "name": "Marketing",
    "hex_color": "#FF5733"
  }'

更新标签

curl -X PUT "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags/:tagUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "name": "Updated Tag Name",
    "hex_color": "#00FF00"
  }'

删除标签

curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags/:tagUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

帖子

获取所有帖子

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts?limit=50&status=scheduled&page=1" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

查询参数：

• limit（数字，默认值：50）：每页返回的结果数量
• status：可选值为 draft、scheduled、published、failed、needs_approval、trash
• keyword（字符串）：按内容搜索帖子
• accounts（数组）：按账号 ID 过滤
• tags（数组）：按标签名称过滤
• page（数字）：分页页码

获取指定帖子

curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/:postUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

创建帖子

curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -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": "Hello from Mixpost API!",
            "media": [1, 2],
            "url": "https://example.com"
          }
        ],
        "options": {}
      }
    ]
  }'

帖子发布选项：

• schedule：设为 true 表示按指定日期/时间定时发布
• schedule_now：设为 true 表示立即发布
• queue：设为 true 表示加入发布队列
• 若以上均未设置，则该帖子将保存为草稿

平台专属选项：

{
  "options": {
    "facebook_page": {
      "type": "post" // post, reel, story
    },
    "instagram": {
      "type": "post" // post, reel, story
    },
    "linkedin": {
      "visibility": "PUBLIC" // PUBLIC, CONNECTIONS
    },
    "mastodon": {
      "sensitive": false // boolean
    },
    "pinterest": {
      "link": null, // null | string
      "title": "", // string
      "boards": {
        "account-1": "971672010430333260" // 键名 `account-*` 是您 Pinterest 账号的 ID
      }
    },
    "youtube": {
      "title": null, // null | string
      "status": "public" // public, private, unlisted
    },
    "gbp": { // Google Business Profile
      "type": "post", // post, offer, event
      "button": "NONE", // NONE, BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL
      "button_link": "", // 若 button 为 NONE 或 CALL，则留空
      "offer_has_details": false, // 仅当 type 为 offer 时生效
      "coupon_code": "", // 仅当 type 为 offer 且 offer_has_details 为 true 时生效
      "offer_link": "", // 仅当 type 为 offer 且 offer_has_details 为 true 时生效
      "terms": "", // 仅当 type 为 offer 且 offer_has_details 为 true 时生效
      "event_title": "", // 仅当 type 为 event 或 offer 时生效
      "start_date": null, // null | string — 仅当 type 为 event 或 offer 时生效
      "end_date": null, // null | string — 仅当 type 为 event 或 offer 时生效
      "event_has_time": false, // 仅当 type 为 event 时生效
      "start_time": "09:00", // 仅当 type 为 event 且 event_has_time 为 true 时生效
      "end_time": "17:00" // 仅当 type 为 event 且 event_has_time 为 true 时生效
    },
    "tiktok": {
      "privacy_level": {
        "account-2": "PUBLIC_TO_EVERYONE" // PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY — 键名 `account-*` 是您 TikTok 账号的 ID
      },
      "allow_comments": {
        "account-2": true // boolean
      },
      "allow_duet": {
        "account-2": false // boolean
      },
      "allow_stitch": {
        "account-2": false // boolean
      },
      "content_disclosure": {
        "account-2": false // boolean
      },
      "brand_organic_toggle": {
        "account-2": false // boolean
      },
      "brand_content_toggle": {
        "account-2": false // boolean
      }
    }
  }
}

更新帖子

curl -X PUT "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/:postUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "content": "Updated post content",
    "schedule_at": "2024-12-25T10:00:00Z",
    "media": ["url1", "url2"],
    "tags": ["tag1", "tag2"],
    "account_ids": ["id1", "id2"]
  }'

删除单个帖子

curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/:postUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "trash": false,
    "delete_mode": "app_only"
  }'

删除模式：

• app_only：仅从应用中删除（默认）
• app_and_social：同时从应用及社交平台删除
• social_only：仅从社交平台删除

批量删除多个帖子

curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "posts": ["post-uuid-1", "post-uuid-2"],
    "trash": false,
    "delete_mode": "app_only"
  }'

调度帖子

curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/schedule/:postUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "postNow": false
  }'

将帖子加入发布队列

curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/add-to-queue/:postUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"

审批帖子

curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/approve/:postUuid" 
  -H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" 
  -H "Accept: application/json"