PiattaformeElencare le piattaforme
Torna a Sofia

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
GET/v1/platforms
curl -X GET 'https://api.sofia-post.com/api/v1/platforms' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorizzazioni

  • Authorizationstringobbligatorio

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

Risposta

200application/json

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)

4XXapplication/json

Qualsiasi altro errore, nella busta di errore.