Piattaforme

Elencare le piattaforme

Elenca ogni rete con nome e regole su media e formati, le stesse di sandbox e simulazione, e se è aperta al titolare del token.

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

Elencare le piattaforme

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

Ogni rete ha le sue regole. Invece di scriverle nel codice, leggile con GET /v1/platforms: la lunghezza massima del testo, gli hashtag e le menzioni, i media accettati, i formati e se la rete è aperta per te.

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

Limiti per rete

Rete	Testo	Media	Formati
Instagram	2.200 caratteri, 30 hashtag, 20 menzioni	Obbligatorio, fino a 10 (JPEG, MP4, MOV)	`post`, `reel`, `story`, `carousel`
Facebook	63.206 caratteri	Fino a 10, foto o video	`post`, `reel`, `story`, `video`
TikTok	2.200 caratteri	Obbligatorio: un video, o fino a 35 foto	`video`, `photo`
LinkedIn	3.000 caratteri	Fino a 20	`post`, `article`, `carousel`, `video`
X	280 caratteri, thread fino a 25 post	Fino a 4, foto o un video	`post`, `thread`

Questi numeri sono quelli di oggi; GET /v1/platforms dà sempre i valori attuali.

La simulazione applica queste stesse regole prima che tu pubblichi.

Autorizzazioni

Authorizationstringheaderobbligatorio
La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Risposta

L'elenco delle piattaforme e delle loro regole.

dataobject[]obbligatorio
Le piattaforme
Mostra gli attributi figli
- platformstringobbligatorio
  Identificatore della rete
  Valori ammessi: instagramfacebookxlinkedintiktok
- namestringobbligatorio
  Nome visualizzato della rete
- availablebooleanobbligatorio
  Aperta alla persona per cui agisce il token; altrimenti una pubblicazione lì viene rifiutata
- captionobjectobbligatorio
  Regole della didascalia
  Mostra gli attributi figli
  - maxLengthnumberobbligatorio
    Numero massimo di caratteri (ponderato su X)
  - enforcedbooleanobbligatorio
    true: la rete rifiuta senza appello oltre i limiti (422 post_refused)
  - maxHashtagsnumber
    Numero massimo di hashtag
  - maxMentionsnumber
    Numero massimo di menzioni
  - threadobject
    Presente quando la rete pubblica un thread
    Mostra gli attributi figli
    maxPostsnumberobbligatorio
    Numero massimo di pubblicazioni in un thread
- mediaobjectobbligatorio
  Regole sui media
  Mostra gli attributi figli
  - maxCountnumberobbligatorio
    Numero massimo di media in una pubblicazione
  - enforcedbooleanobbligatorio
    true: la rete rifiuta senza appello oltre il limite
  - mixImagesAndVideobooleanobbligatorio
    false: foto e video non si possono mescolare in una pubblicazione
  - imageTypesstring[]obbligatorio
    Tipi MIME di immagine accettati
  - videoTypesstring[]obbligatorio
    Tipi MIME di video accettati
- formatsobject[]obbligatorio
  Formati accettati dalla rete
  Mostra gli attributi figli
  - formatstringobbligatorio
    Nome del formato
  - defaultbooleanobbligatorio
    Il formato usato quando la destinazione non ne dichiara nessuno
  - requiredMediastringobbligatorio
    none: pubblicabile senza visual; any: un visual di qualsiasi tipo
    Valori ammessi: noneimagevideoany
  - captionPublishedbooleanobbligatorio
    false: la didascalia non viene inviata (story)

Questa pagina ti è stata utile?