Платформы

Список платформ

Перечисляет каждую сеть с названием, правилами медиа и форматов (те же, что в песочнице и пробном запуске) и признаком, открыта ли она владельцу токена.

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: подпись не отправляется (story)

Эта страница была полезной?