Plattformen

Plattformen auflisten

Listet jedes Netzwerk mit Bezeichnung sowie Medien- und Formatregeln auf, die auch Sandbox und Probelauf anwenden, und ob es dem Token-Inhaber offensteht.

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

Plattformen auflisten

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

Jedes Netzwerk hat eigene Regeln. Statt sie fest zu codieren, lies sie über GET /v1/platforms: die maximale Textlänge, Hashtags und Erwähnungen, die akzeptierten Medien, die Formate und ob das Netzwerk für dich geöffnet ist.

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

Grenzen pro Netzwerk

Netzwerk	Text	Medien	Formate
Instagram	2.200 Zeichen, 30 Hashtags, 20 Erwähnungen	Pflicht, bis zu 10 (JPEG, MP4, MOV)	`post`, `reel`, `story`, `carousel`
Facebook	63.206 Zeichen	Bis zu 10, Fotos oder Videos	`post`, `reel`, `story`, `video`
TikTok	2.200 Zeichen	Pflicht: ein Video oder bis zu 35 Fotos	`video`, `photo`
LinkedIn	3.000 Zeichen	Bis zu 20	`post`, `article`, `carousel`, `video`
X	280 Zeichen, Threads bis zu 25 Posts	Bis zu 4, Fotos oder ein Video	`post`, `thread`

Diese Zahlen sind die von heute; GET /v1/platforms liefert immer die aktuellen Werte.

Die Simulation wendet dieselben Regeln an, bevor du veröffentlichst.

Autorisierungen

Authorizationstringheadererforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Antwort

Die Liste der Plattformen und ihrer Regeln.

dataobject[]erforderlich
Die Plattformen
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Kennung des Netzwerks
  Zulässige Werte: instagramfacebookxlinkedintiktok
- namestringerforderlich
  Anzeigename des Netzwerks
- availablebooleanerforderlich
  Offen für die Person, für die das Token handelt; sonst wird ein Beitrag dort abgelehnt
- captionobjecterforderlich
  Regeln für die Bildunterschrift
  Untergeordnete Attribute anzeigen
  - maxLengthnumbererforderlich
    Höchstzahl der Zeichen (auf X gewichtet)
  - enforcedbooleanerforderlich
    true: Das Netzwerk lehnt Überschreitungen der Grenzen glatt ab (422 post_refused)
  - maxHashtagsnumber
    Höchstzahl der Hashtags
  - maxMentionsnumber
    Höchstzahl der Erwähnungen
  - threadobject
    Vorhanden, wenn das Netzwerk einen Thread veröffentlicht
    Untergeordnete Attribute anzeigen
    maxPostsnumbererforderlich
    Höchstzahl der Beiträge in einem Thread
- mediaobjecterforderlich
  Medienregeln
  Untergeordnete Attribute anzeigen
  - maxCountnumbererforderlich
    Höchstzahl der Medien in einem Beitrag
  - enforcedbooleanerforderlich
    true: Das Netzwerk lehnt Überschreitungen der Grenze glatt ab
  - mixImagesAndVideobooleanerforderlich
    false: Fotos und Video lassen sich nicht in einem Beitrag mischen
  - imageTypesstring[]erforderlich
    Akzeptierte MIME-Typen für Bilder
  - videoTypesstring[]erforderlich
    Akzeptierte MIME-Typen für Videos
- formatsobject[]erforderlich
  Vom Netzwerk akzeptierte Formate
  Untergeordnete Attribute anzeigen
  - formatstringerforderlich
    Name des Formats
  - defaultbooleanerforderlich
    Das Format, das gilt, wenn das Ziel keines angibt
  - requiredMediastringerforderlich
    none: ohne Bild veröffentlichbar; any: ein Bild beliebiger Art
    Zulässige Werte: noneimagevideoany
  - captionPublishedbooleanerforderlich
    false: Die Bildunterschrift wird nicht gesendet (Story)

War diese Seite hilfreich?