平台

列出平台

列出各網絡的名稱、文案、媒體和格式規則，與沙盒和試執行所用的規則一致，並標明權杖所有者能否使用該網絡，便於發布前核對。

GEThttps://api.sofia-post.com/api/v1/platforms

列出平台

curl -X GET 'https://api.sofia-post.com/api/v1/platforms' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "platform": "instagram",
      "name": "Instagram",
      "available": true,
      "caption": {
        "maxLength": 2200,
        "maxHashtags": 30,
        "maxMentions": 20,
        "enforced": true
      },
      "media": {
        "maxCount": 10,
        "enforced": true,
        "mixImagesAndVideo": true,
        "imageTypes": [
          "string"
        ],
        "videoTypes": [
          "string"
        ]
      },
      "formats": [
        {
          "format": "post",
          "default": true,
          "requiredMedia": "none",
          "captionPublished": true
        }
      ]
    }
  ]
}

列出平台

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/platforms' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "platform": "instagram",
      "name": "Instagram",
      "available": true,
      "caption": {
        "maxLength": 2200,
        "maxHashtags": 30,
        "maxMentions": 20,
        "enforced": true
      },
      "media": {
        "maxCount": 10,
        "enforced": true,
        "mixImagesAndVideo": true,
        "imageTypes": [
          "string"
        ],
        "videoTypes": [
          "string"
        ]
      },
      "formats": [
        {
          "format": "post",
          "default": true,
          "requiredMedia": "none",
          "captionPublished": true
        }
      ]
    }
  ]
}

每個平台都有自己的規則。與其把它們寫死在程式碼裡，不如透過 GET /v1/platforms 讀取：文字的最大長度、主題標籤和提及、接受的媒體、格式，以及該平台是否對你開放。

{
  "data": [
    {
      "platform": "instagram",
      "name": "Instagram",
      "available": true,
      "caption": { "maxLength": 2200, "maxHashtags": 30, "maxMentions": 20, "enforced": true },
      "media": { "maxCount": 10, "mixImagesAndVideo": true, "imageTypes": ["image/jpeg"], "videoTypes": ["video/mp4", "video/quicktime"] },
      "formats": [
        { "format": "post", "default": true, "requiredMedia": "any" },
        { "format": "reel", "default": false, "requiredMedia": "video" }
      ]
    }
  ]
}

各平台的限制

平台	文字	媒體	格式
Instagram	2,200 個字元、30 個主題標籤、20 個提及	必填，最多 10 個（JPEG、MP4、MOV）	`post`、`reel`、`story`、`carousel`
Facebook	63,206 個字元	最多 10 個，照片或影片	`post`、`reel`、`story`、`video`
TikTok	2,200 個字元	必填：一個影片，或最多 35 張照片	`video`、`photo`
LinkedIn	3,000 個字元	最多 20 個	`post`、`article`、`carousel`、`video`
X	280 個字元，串文最多 25 條帖文	最多 4 個，照片或一個影片	`post`、`thread`

這些數字是當前的數字；GET /v1/platforms 始終返回最新的值。

模擬會在你發布之前應用程式同樣的規則。

授權

Authorizationstringheader必填
你的個人金鑰或 OAuth 存取權杖，以 Bearer <token> 傳送。

回應

平台及其規則列表。

dataobject[]必填
平台
顯示子屬性
- platformstring必填
  網絡的識別碼
  允許的值： instagramfacebookxlinkedintiktok
- namestring必填
  網絡的顯示名稱
- availableboolean必填
  權杖所代表的用戶可用；否則發到該網絡的帖文會被拒絕
- captionobject必填
  文案規則
  顯示子屬性
  - maxLengthnumber必填
    最大字符數（在 X 上按權重計算）
  - enforcedboolean必填
    true：超出限制時網絡會直接拒絕（422 post_refused）
  - maxHashtagsnumber
    最大主題標籤數
  - maxMentionsnumber
    最大提及數
  - threadobject
    網絡發布串文時出現
    顯示子屬性
    maxPostsnumber必填
    串文中的最大帖文數
- mediaobject必填
  媒體規則
  顯示子屬性
  - maxCountnumber必填
    一條帖文中的最大媒體數
  - enforcedboolean必填
    true：超出限制時網絡會直接拒絕
  - mixImagesAndVideoboolean必填
    false：一條帖文中不能混用照片和影片
  - imageTypesstring[]必填
    接受的圖片 MIME 類型
  - videoTypesstring[]必填
    接受的影片 MIME 類型
- formatsobject[]必填
  網絡接受的格式
  顯示子屬性
  - formatstring必填
    格式名稱
  - defaultboolean必填
    目標未宣告格式時使用的格式
  - requiredMediastring必填
    none：無需視覺素材即可發布；any：任意類型的視覺素材
    允許的值： noneimagevideoany
  - captionPublishedboolean必填
    false：不傳送文案（限時動態）

這個頁面對你有幫助嗎？