Platform

Daftar platform

Mendaftar setiap jaringan beserta aturan caption, media, dan format, sama dengan yang diterapkan sandbox dan dry run, serta apakah terbuka bagi pemilik token.

GEThttps://api.sofia-post.com/api/v1/platforms

Daftar platform

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

Daftar platform

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

Setiap jaringan punya aturannya sendiri. Daripada menuliskannya secara permanen di kode, bacalah lewat GET /v1/platforms: panjang teks maksimal, tagar dan sebutan, media yang diterima, format, dan apakah jaringan itu terbuka untuk Anda.

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

Batas per jaringan

Jaringan	Teks	Media	Format
Instagram	2.200 karakter, 30 tagar, 20 sebutan	Wajib, hingga 10 (JPEG, MP4, MOV)	`post`, `reel`, `story`, `carousel`
Facebook	63.206 karakter	Hingga 10, foto atau video	`post`, `reel`, `story`, `video`
TikTok	2.200 karakter	Wajib: satu video, atau hingga 35 foto	`video`, `photo`
LinkedIn	3.000 karakter	Hingga 20	`post`, `article`, `carousel`, `video`
X	280 karakter, utas hingga 25 post	Hingga 4, foto atau satu video	`post`, `thread`

Angka-angka ini adalah angka hari ini; GET /v1/platforms selalu memberi nilai terkini.

Simulasi menerapkan aturan yang sama sebelum Anda menerbitkan.

Otorisasi

Authorizationstringheaderwajib
Kunci pribadi atau access token OAuth Anda, dikirim sebagai Bearer <token>.

Respons

Daftar platform dan aturannya.

dataobject[]wajib
Platform
Tampilkan atribut turunan
- platformstringwajib
  Pengenal jaringan
  Nilai yang diizinkan: instagramfacebookxlinkedintiktok
- namestringwajib
  Nama tampilan jaringan
- availablebooleanwajib
  Terbuka bagi orang yang diwakili token; bila tidak, postingan di sana ditolak
- captionobjectwajib
  Aturan caption
  Tampilkan atribut turunan
  - maxLengthnumberwajib
    Jumlah karakter maksimum (berbobot di X)
  - enforcedbooleanwajib
    true: jaringan menolak mentah-mentah di atas batas (422 post_refused)
  - maxHashtagsnumber
    Jumlah hashtag maksimum
  - maxMentionsnumber
    Jumlah mention maksimum
  - threadobject
    Ada bila jaringan memublikasikan thread
    Tampilkan atribut turunan
    maxPostsnumberwajib
    Jumlah maksimum postingan dalam thread
- mediaobjectwajib
  Aturan media
  Tampilkan atribut turunan
  - maxCountnumberwajib
    Jumlah media maksimum dalam satu postingan
  - enforcedbooleanwajib
    true: jaringan menolak mentah-mentah di atas batas
  - mixImagesAndVideobooleanwajib
    false: foto dan video tidak bisa dicampur dalam satu postingan
  - imageTypesstring[]wajib
    Tipe MIME gambar yang diterima
  - videoTypesstring[]wajib
    Tipe MIME video yang diterima
- formatsobject[]wajib
  Format yang diterima jaringan
  Tampilkan atribut turunan
  - formatstringwajib
    Nama format
  - defaultbooleanwajib
    Format yang dipakai bila target tidak menyebutkan
  - requiredMediastringwajib
    none: bisa dipublikasikan tanpa visual; any: visual jenis apa pun
    Nilai yang diizinkan: noneimagevideoany
  - captionPublishedbooleanwajib
    false: caption tidak dikirim (story)

Apakah halaman ini membantu?