Статусы и события#

Результат публикации можно узнать двумя способами: прочитать пост (GET /v1/posts/{id}) или читать ленту событий проекта (GET /v1/events). Для интеграций удобнее лента: один запрос раз в минуту покрывает все посты проекта.

Статусы цели#

У поста есть цель (targets[]) на каждый канал. Статус цели:

Статус поста#

Считается по целям:

outcome_unknown: что это значит и почему не повторять вручную#

Публикация в Instagram — два шага: создание контейнера с медиа и команда «опубликовать». Если сеть оборвалась или процесс упал после команды «опубликовать», но до ответа, мы не знаем, вышел ли пост. Сервис сам сверяется с Instagram по сохранённому контейнеру и в большинстве случаев выясняет исход (published или failed). Статус outcome_unknown означает, что выяснить не удалось.

Не повторяйте такую публикацию вручную и не создавайте тот же пост заново: если пост на самом деле вышел, вы получите дубль в ленте клиента, а Instagram дублей не отменяет. Сначала откройте профиль и проверьте, есть ли пост. POST /v1/post-targets/{id}:retry для outcome_unknown нарочно не работает (409 target_not_failed). Решение принимаете вы: нет поста — создайте новый (с новым Idempotency-Key).

Лента событий#

GET /v1/events?after=<seq>&limit=<n> возвращает события проекта строго по порядку:

{
  "data": [
    {
      "seq": 12,
      "type": "post.published",
      "created_at": "2026-11-05T09:10:41+00:00",
      "data": {
        "post_id": "01a1ab14-b9ae-7504-b304-8e6602f58395",
        "target_id": "01a1ab14-b9af-7ab3-8e2b-4bb0ff2a1c03",
        "channel_id": "01a1ab14-9628-798c-b1d0-77dbd5211c06",
        "external_ref": "social_post:42",
        "post_status": "published",
        "target_status": "published",
        "external_id": "17900000000000000",
        "permalink": "https://www.instagram.com/p/XXXXXXXXXXX/",
        "retry_at": null,
        "error_code": null,
        "error_message": null
      }
    }
  ],
  "next_after": 12
}

seq — порядковый номер события в проекте. Храните последний обработанный seq и передавайте его как after: получите только новые события. Пустой data — новых событий нет (next_after равен переданному after). limit — до 500, по умолчанию 100. События хранятся по порядку и не пропадают между запросами, поэтому достаточно опрашивать ленту раз в минуту.

# Лента событий проекта: храните next_after и передавайте его как after
curl -sS --fail-with-body -H "$AUTH" "$API_URL/v1/events?after=0&limit=50" \
  | jq -r '(.data[] | "event: \(.seq) \(.type) \(.data.post_id // "")"), "next_after: \(.next_after)"'

# Лента событий проекта: храните next_after и передавайте его как after
feed = api("GET", "/v1/events?after=0&limit=50")
for event in feed["data"]:
    print("event:", event["seq"], event["type"], event["data"].get("post_id", ""))
print("next_after:", feed["next_after"])

// Лента событий проекта: храните next_after и передавайте его как after
const feed = await api("GET", "/v1/events?after=0&limit=50");
for (const event of feed.data) {
  console.log("event:", event.seq, event.type, event.data.post_id ?? "");
}
console.log("next_after:", feed.next_after);

// Лента событий проекта: храните next_after и передавайте его как after
$feed = api('GET', '/v1/events?after=0&limit=50');
foreach ($feed['data'] as $event) {
    echo 'event: ', $event['seq'], ' ', $event['type'], ' ', $event['data']['post_id'] ?? '', "\n";
}
echo 'next_after: ', $feed['next_after'], "\n";

// Лента событий проекта: храните next_after и передавайте его как after
var feed struct {
	Data []struct {
		Seq  int            `json:"seq"`
		Type string         `json:"type"`
		Data map[string]any `json:"data"`
	} `json:"data"`
	NextAfter int `json:"next_after"`
}
api("GET", "/v1/events?after=0&limit=50", nil, "", "", &feed)
for _, e := range feed.Data {
	fmt.Println("event:", e.Seq, e.Type, e.Data["post_id"])
}
fmt.Println("next_after:", feed.NextAfter)

Типы событий#

События post.* — по одному на смену статуса цели. Поля data у всех одинаковы (см. пример выше).

События статуса, который не поменялся, повторно не создаются. События канала не дублируются: channel.connected после продления токена в ленте второй раз не появляется.

Ретраи#

Сбои сети и временные ошибки Instagram сервис повторяет сам: до 6 попыток с нарастающей задержкой, не позже чем через 24 часа от publish_at. Если попытки закончились, цель становится failed (или outcome_unknown, если неясно, вышел ли пост). Квоту публикаций Instagram и лимит запросов сервис учитывает заранее и откладывает цель (deferred), не тратя попытки. Для упавшей цели, которую хотите повторить сами, есть POST /v1/post-targets/{id}:retry (только failed).