プラットフォーム

プラットフォームを一覧表示する

各ネットワークの名称、キャプション・メディア・フォーマットの規則（サンドボックスやドライランと同じ）と、トークン所有者に開放されているかを返します。

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 文字	必須：動画 1 本、または写真が最大 35 枚	`video`、`photo`
LinkedIn	3,000 文字	最大 20 件	`post`、`article`、`carousel`、`video`
X	280 文字、スレッドは最大 25 ポスト	写真は最大 4 枚、または動画 1 本	`post`、`thread`

これらの数値は現時点のものです。GET /v1/platforms は常に現在の値を返します。

ドライランは、公開の前に、これと同じルールを適用します。

認可

Authorizationstringheader必須
個人キーまたは OAuth アクセストークン。Bearer <token> として送信します。

レスポンス

プラットフォームとその規則の一覧。

dataobject[]必須
プラットフォーム
子属性を表示
- platformstring必須
  ネットワークの ID
  使用できる値： instagramfacebookxlinkedintiktok
- namestring必須
  ネットワークの表示名
- availableboolean必須
  トークンが代理する人に開放されています。そうでない場合、そこへの投稿は拒否されます
- captionobject必須
  キャプションの規則
  子属性を表示
  - maxLengthnumber必須
    最大文字数（X では重み付け）
  - enforcedboolean必須
    true：上限を超えるとネットワークが一律に拒否します（422 post_refused）
  - maxHashtagsnumber
    ハッシュタグの最大数
  - maxMentionsnumber
    メンションの最大数
  - threadobject
    ネットワークがスレッドを公開する場合に含まれます
    子属性を表示
    maxPostsnumber必須
    スレッドの最大投稿数
- mediaobject必須
  メディアの規則
  子属性を表示
  - maxCountnumber必須
    1 件の投稿に含められるメディアの最大数
  - enforcedboolean必須
    true：上限を超えるとネットワークが一律に拒否します
  - mixImagesAndVideoboolean必須
    false：1 件の投稿に写真と動画を混在できません
  - imageTypesstring[]必須
    対応する画像の MIME タイプ
  - videoTypesstring[]必須
    対応する動画の MIME タイプ
- formatsobject[]必須
  ネットワークが受け付けるフォーマット
  子属性を表示
  - formatstring必須
    フォーマットの名前
  - defaultboolean必須
    ターゲットが指定しない場合に使うフォーマット
  - requiredMediastring必須
    none：ビジュアルなしで公開可能。any：種類を問わずビジュアルが必要
    使用できる値： noneimagevideoany
  - captionPublishedboolean必須
    false：キャプションは送信されません（ストーリーズ）

このページは役に立ちましたか？