APIAPI Publikacji w Social Media

Zaplanuj gotowe wideo
bez otwierania panelu

Jedno wywołanie kolejkuje wyrenderowane wideo na podłączonym koncie, co do minuty. Odczytaj kalendarz, filtruj kolejkę po statusie i pozwól podpisanemu webhookowi powiedzieć, kiedy naprawdę poszło.

POSThttps://autostud.ai/api/v1/actions/publishing.schedule_post

Zdobądź klucz API Dokumentacja API

Trzy wywołania, od renderu do publikacji

Znajdź cel raz, a potem planuj, ile chcesz.

Znajdź cel

Podłączone konta są przez API tylko do odczytu: łączy się je raz z panelu, bo materiał OAuth nigdy nie może opuścić serwera. Wypisz je i zachowaj id.

export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Read-only on purpose: accounts are connected from the dashboard,
# so the OAuth tokens never leave the server.
curl "https://autostud.ai/api/v1/social_accounts?status=active&limit=10" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"

Zaplanuj post

Wideo, konto, moment i opis. Wywołanie zwraca post w kolejce, a nie opublikowany, więc twój własny harmonogram pozostaje źródłem prawdy.

curl -X POST https://autostud.ai/api/v1/actions/publishing.schedule_post \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lighthouse-ep12-tiktok" \
  -d '{
    "video_id": "0f4c8b71-2d95-47a3-9e6c-15b8ad7f3c20",
    "account_id": "9a2c6f18-4b70-4d35-8e91-0f7d3c84b562",
    "scheduled_at": "2026-08-21T18:30:00.000Z",
    "caption": "Episode 12: the keeper who never slept #lighthouse"
  }'

Patrz, jak wychodzi

Czytaj kalendarz pogrupowany po dniach, filtruj kolejkę po statusie albo weź post.published i przestań pytać. Błędy przychodzą tak samo, z dołączonym powodem.

curl -X POST https://autostud.ai/api/v1/actions/publishing.calendar \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "2026-08-17", "to": "2026-08-24" }'

# Need something more specific? The queue is a plain resource:
curl "https://autostud.ai/api/v1/scheduled_posts?status=error&platform=tiktok" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"

Co przyjmuje zaplanowany post

Cztery pola. Wyrenderowany plik, cel, minuta i słowa.

video_id

Wideo do opublikowania. Musi być wyrenderowane: kolejka publikuje plik, a nie oś czasu.

account_id

Na które podłączone konto trafia. Jeden post, jeden cel, więc błąd nigdy nie pociąga za sobą pozostałych.

scheduled_at

Kiedy ma wyjść. Wszystko, co platforma akceptuje, łącznie z "teraz".

caption

Opis, który mu towarzyszy. Hashtagi i wzmianki podróżują w nim dokładnie tak, jak je wpisano.

Kolejka, czytelna w obie strony

Kalendarz odpowiada na "co wychodzi w tym tygodniu", zasób odpowiada na "co się stało z tym wideo". Oba da się filtrować, więc panel buduje się bez ani jednego dodatkowego endpointu.

GET /api/v1/social_accountsGET /api/v1/scheduled_postspublishing.calendar

Wiedz, kiedy naprawdę poszło

Zaplanowanie to obietnica, nie wynik. post.published wyzwala się, gdy platforma przyjęła materiał, także przy publikacji częściowej, gdzie ładunek niesie wynik per konto.

post.publishedpost.failed

O co programiści pytają najpierw

Czy mogę podłączyć konto przez API?

Nie i jest to celowe. Konta podłącza się z panelu, żeby tokeny OAuth nigdy nie opuściły serwera; API może je wypisać i na nie publikować, nic więcej.

Co, jeśli platforma odrzuci post?

Post zostaje w kolejce ze statusem błędu, a post.failed wyzwala się z powodem. Nic nie jest po cichu ponawiane za twoimi plecami.

Czy mogę opublikować to samo wideo na kilku kontach?

Tak: jedno wywołanie na cel. Trzymanie ich osobno sprawia, że platforma odrzucająca opis nie anuluje wszystkich pozostałych.

Jak zbudować widok kalendarza?

publishing.calendar zwraca zaplanowane posty pogrupowane po dniach między dwiema datami. Po coś bardziej szczegółowego filtruj zasób scheduled_posts po status, platform lub video_id.

Specyfikacja OpenAPI Kody błędów Poznaj API