Instagram story API: STORIES konteyneri va e'lon qilish

Instagram story API orqali qanday joylanadi?

Story media talablari

Bu talablarni SDK ham, kabinet ham tekshira olmaydi — fayl Meta tomonda yuklanadi. Mos kelmasa konteyner ERROR holatiga tushadi.

boryo'q

PNG va WebP qabul qilinmaydi — yuklashdan oldin JPEG'ga o'tkazing. Havola avtorizatsiya so'rasa yoki muddati tugagan bo'lsa, Meta faylni ololmaydi.

Xom so'rovlar: konteyner va e'lon

SDK'siz ham oqim aynan shunday. Birinchi javobda konteyner id'si keladi, u ikkinchi so'rovga creation_id bo'lib kiradi.

# 1) Story konteyneri
curl -X POST "https://graph.facebook.com/v26.0/$IG_ID/media" \
  -d "image_url=https://cdn.example.com/story.jpg" \
  -d "media_type=STORIES" \
  -d "access_token=$TOKEN"
# -> {"id":"17998...."}

# 2) Video bo'lsa — konteyner holatini kuting
curl -G "https://graph.facebook.com/v26.0/17998...." \
  -d "fields=status_code" -d "access_token=$TOKEN"
# -> {"status_code":"FINISHED"}

# 3) E'lon qilish
curl -X POST "https://graph.facebook.com/v26.0/$IG_ID/media_publish" \
  -d "creation_id=17998...." -d "access_token=$TOKEN"

Nega story konteynerida caption yo'q

Ruxsatlar: ikki login yo'li uchun

Instagram'ning ikki oqimi bor va ular uchun scope'lar butunlay boshqacha. Facebook sahifasi faqat bitta yo'lda kerak.

Facebook Login yo'lida foydalanuvchi Page rolini Business Manager orqali olgan bo'lsa, qo'shimcha ads_management yoki ads_read kerak bo'ladi.

Faol story'lar ro'yxatini kim o'qiy oladi

Kunlik limit: hujjatning o'zida ikki xil raqam

Socialift SDK bilan Instagram story joylash

SDK konteyner yaratish, kutish va e'lon qilishni bitta chaqiruvga yig'adi va container_id bilan media_id qaytaradi.

import asyncio, os
from socialift import ContainerNotReadyError, Instagram

CDN = "https://cdn.example.com"

async def main():
    token = os.environ["IG_USER_TOKEN"]
    async with Instagram.from_env() as ig:
        photo = await ig.publish_story(token, image_url=f"{CDN}/story.jpg")
        try:
            clip = await ig.publish_story(token, video_url=f"{CDN}/story.mp4", wait_timeout=120.0)
        except ContainerNotReadyError as exc:
            print("konteyner hali tayyor emas:", exc.container_id)
            return
        active = await ig.stories(token, limit=25)
        print(photo["media_id"], clip["media_id"], len(active))

asyncio.run(main())

Facebook Page story: rasm va video oqimi

Page story'lari Instagram'dagi konteyner oqimini umuman ishlatmaydi — bu yerda ikki xil, o'ziga xos protokol bor.

1. 1

   Rasm: avval e'lon qilinmagan rasm

   photo_stories edge'i faqat photo_id oladi, havola qabul qilmaydi. Shuning uchun avval POST /<PAGE_ID>/photos?published=false&url=<havola> chaqiriladi — u faqat id qaytaradi va rasm lentada ko'rinmaydi.

2. 2

   Rasm: story sifatida e'lon qilish

   Olingan id bilan POST /<PAGE_ID>/photo_stories?photo_id=<id>. E'lon qilinmagan rasm Facebook serverida taxminan 24 soat turadi, shundan keyin photo_id yaroqsiz bo'ladi.

3. 3

   Video: sessiyani ochish

   POST /<PAGE_ID>/video_stories?upload_phase=start — javobda video_id va upload_url keladi. upload_url rupload.facebook.com ga ishora qiladi va uni o'zingiz yig'maysiz, javobdan olasiz.

4. 4

   Video: faylni yuklash

   O'sha upload_url ga POST. Token bu qadamda query'da emas, Authorization: OAuth <token> sarlavhasida ketadi. Havola bersangiz file_url sarlavhasi va bo'sh tana, fayl bersangiz offset va file_size sarlavhalari va tanada baytlar.

5. 5

   Video: yakunlash

   POST /<PAGE_ID>/video_stories?upload_phase=finish&video_id=<id>. Bundan oldin holat uploading_phase.status == "complete" bo'lishini kuting: GET /<VIDEO_ID>?fields=status.

Page story: SDK namunasi va uzilgan yuklash

SDK ikkala oqimni ham ichida bajaradi: rasm uchun ikki qadamni, video uchun uch qadamni va uzilgan yuklashni davom ettirishni.

import asyncio, os
from socialift import Facebook

async def main():
    page_id = os.environ["FB_PAGE_ID"]
    page_token = os.environ["FB_PAGE_TOKEN"]
    async with Facebook.from_env() as fb:
        photo = await fb.publish_photo_story(
            page_id, page_token, photo_url="https://cdn.example.com/story.jpg"
        )
        clip = await fb.publish_video_story(
            page_id, page_token, video="/srv/media/story.mp4", upload_attempts=3
        )
        state = await fb.video_story_status(clip["video_id"], page_token)
        print(photo["post_id"], state.get("publishing_phase"))

        for item in await fb.stories(page_id, page_token, limit=25):
            print(item["post_id"], item["status"])

asyncio.run(main())

Tipik xatolar va ulardan qochish

• ▸Rasm PNG yoki WebP — Instagram story uchun faqat JPEG qabul qilinadi.
• ▸Havola imzolangan va muddati tugagan yoki login so'raydi — Meta faylni o'sha payt yuklab oladi.
• ▸Video konteyneri FINISHED bo'lmasdan media_publish chaqirilgan.
• ▸Bitta konteynerga ham image_url, ham video_url berilgan.
• ▸Story'ga caption yoki stiker kutilmoqda — API ularni qo'ymaydi.
• ▸Instagram Login tokeni bilan GET /<IG_ID>/stories chaqirilgan — bu edge u yerda yo'q.
• ▸Kunlik limit kodga raqam bilan yozilgan — uni content_publishing_limit dan o'qing.
• ▸Page story videosi 540p dan past — xato uchinchi qadamda emas, yuklashdan keyingi holatda chiqadi.
• ▸Page rasmi 24 soatdan ko'p kutib qolgan: e'lon qilinmagan photo_id eskirgan.