平台列出平台
返回 Sofia

平台

列出平台

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

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

授權

  • Authorizationstring必填

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

回應

200application/json

平台及其規則列表。

  • 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：不傳送文案（限時動態）

4XXapplication/json

其他任何錯誤，以錯誤結構回傳。