Plateformes

Lister les plateformes

Liste chaque réseau avec son libellé et ses règles de médias et de formats, celles du bac à sable et de la simulation, et s’il est ouvert au détenteur du jeton.

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
        }
      ]
    }
  ]
}

Lister les plateformes

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
        }
      ]
    }
  ]
}

Chaque réseau a ses propres règles. Plutôt que de les coder en dur, lisez-les via GET /v1/platforms : la longueur maximale du texte, les hashtags et mentions, les médias acceptés, les formats, et si le réseau vous est ouvert.

{
  "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" }
      ]
    }
  ]
}

Limites par réseau

Réseau	Texte	Médias	Formats
Instagram	2 200 caractères, 30 hashtags, 20 mentions	Obligatoire, jusqu’à 10 (JPEG, MP4, MOV)	`post`, `reel`, `story`, `carousel`
Facebook	63 206 caractères	Jusqu’à 10, photos ou vidéos	`post`, `reel`, `story`, `video`
TikTok	2 200 caractères	Obligatoire : une vidéo, ou jusqu’à 35 photos	`video`, `photo`
LinkedIn	3 000 caractères	Jusqu’à 20	`post`, `article`, `carousel`, `video`
X	280 caractères, fils jusqu’à 25 posts	Jusqu’à 4, photos ou une vidéo	`post`, `thread`

Ces chiffres sont ceux d’aujourd’hui ; GET /v1/platforms donne toujours les valeurs actuelles.

La simulation applique ces mêmes règles avant que vous publiiez.

Autorisations

Authorizationstringheaderrequis
Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Réponse

La liste des plateformes et de leurs règles.

dataobject[]requis
Les plateformes
Afficher les attributs enfants
- platformstringrequis
  Identifiant du réseau
  Valeurs autorisées : instagramfacebookxlinkedintiktok
- namestringrequis
  Nom d’affichage du réseau
- availablebooleanrequis
  Ouvert à la personne pour qui le jeton agit ; sinon, une publication y est refusée
- captionobjectrequis
  Règles de légende
  Afficher les attributs enfants
  - maxLengthnumberrequis
    Nombre maximal de caractères (pondéré sur X)
  - enforcedbooleanrequis
    true : le réseau refuse tout net au-delà des limites (422 post_refused)
  - maxHashtagsnumber
    Nombre maximal de hashtags
  - maxMentionsnumber
    Nombre maximal de mentions
  - threadobject
    Présent quand le réseau publie un fil
    Afficher les attributs enfants
    maxPostsnumberrequis
    Nombre maximal de publications dans un fil
- mediaobjectrequis
  Règles de médias
  Afficher les attributs enfants
  - maxCountnumberrequis
    Nombre maximal de médias dans une publication
  - enforcedbooleanrequis
    true : le réseau refuse tout net au-delà de la limite
  - mixImagesAndVideobooleanrequis
    false : photos et vidéo ne peuvent pas être mélangées dans une publication
  - imageTypesstring[]requis
    Types MIME d’image acceptés
  - videoTypesstring[]requis
    Types MIME de vidéo acceptés
- formatsobject[]requis
  Formats acceptés par le réseau
  Afficher les attributs enfants
  - formatstringrequis
    Nom du format
  - defaultbooleanrequis
    Le format utilisé quand la cible n’en déclare aucun
  - requiredMediastringrequis
    none : publiable sans visuel ; any : un visuel de n’importe quel type
    Valeurs autorisées : noneimagevideoany
  - captionPublishedbooleanrequis
    false : la légende n’est pas envoyée (story)

Cette page vous a-t-elle aidé ?