Plataformas

Listar las plataformas

Lista cada red con su nombre y sus reglas de medios y formatos, las mismas que aplican el sandbox y la simulación, y si está abierta al titular 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
        }
      ]
    }
  ]
}

Listar las plataformas

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

Cada red tiene sus propias reglas. En lugar de codificarlas a mano, léelas con GET /v1/platforms: la longitud máxima del texto, los hashtags y menciones, los archivos admitidos, los formatos y si la red está abierta para ti.

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

Límites por red

Red	Texto	Archivos	Formatos
Instagram	2.200 caracteres, 30 hashtags, 20 menciones	Obligatorio, hasta 10 (JPEG, MP4, MOV)	`post`, `reel`, `story`, `carousel`
Facebook	63.206 caracteres	Hasta 10, fotos o vídeos	`post`, `reel`, `story`, `video`
TikTok	2.200 caracteres	Obligatorio: un vídeo, o hasta 35 fotos	`video`, `photo`
LinkedIn	3.000 caracteres	Hasta 20	`post`, `article`, `carousel`, `video`
X	280 caracteres, hilos de hasta 25 posts	Hasta 4, fotos o un vídeo	`post`, `thread`

Estas cifras son las de hoy; GET /v1/platforms siempre da los valores actuales.

La simulación aplica estas mismas reglas antes de que publiques.

Autorizaciones

Authorizationstringheaderobligatorio
Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Respuesta

La lista de plataformas y sus reglas.

dataobject[]obligatorio
Las plataformas
Mostrar atributos hijos
- platformstringobligatorio
  Identificador de la red
  Valores permitidos: instagramfacebookxlinkedintiktok
- namestringobligatorio
  Nombre visible de la red
- availablebooleanobligatorio
  Abierta a la persona por la que actúa el token; si no, una publicación allí se rechaza
- captionobjectobligatorio
  Reglas del pie de publicación
  Mostrar atributos hijos
  - maxLengthnumberobligatorio
    Número máximo de caracteres (ponderado en X)
  - enforcedbooleanobligatorio
    true: la red rechaza sin más lo que supere los límites (422 post_refused)
  - maxHashtagsnumber
    Número máximo de hashtags
  - maxMentionsnumber
    Número máximo de menciones
  - threadobject
    Presente cuando la red publica un hilo
    Mostrar atributos hijos
    maxPostsnumberobligatorio
    Número máximo de publicaciones en un hilo
- mediaobjectobligatorio
  Reglas de medios
  Mostrar atributos hijos
  - maxCountnumberobligatorio
    Número máximo de medios en una publicación
  - enforcedbooleanobligatorio
    true: la red rechaza sin más lo que supere el límite
  - mixImagesAndVideobooleanobligatorio
    false: no se pueden mezclar fotos y vídeo en una publicación
  - imageTypesstring[]obligatorio
    Tipos MIME de imagen aceptados
  - videoTypesstring[]obligatorio
    Tipos MIME de vídeo aceptados
- formatsobject[]obligatorio
  Formatos que acepta la red
  Mostrar atributos hijos
  - formatstringobligatorio
    Nombre del formato
  - defaultbooleanobligatorio
    El formato que se usa cuando el destino no declara ninguno
  - requiredMediastringobligatorio
    none: publicable sin imagen; any: una imagen de cualquier tipo
    Valores permitidos: noneimagevideoany
  - captionPublishedbooleanobligatorio
    false: el pie no se envía (story)

¿Te ha resultado útil esta página?