Справочник API
Публичный API Feedigy v1. Только bearer-токены, версия в пути, курсорная пагинация, идемпотентные записи и подписанные вебхуки.
Начните с быстрого старта. Лимиты, ошибки и повторы — в политиках. Машинный контракт — openapi.json (OpenAPI 3.1.0, version 1.0.0).
Базовые URL и аутентификация
| Среда | Базовый URL |
|---|---|
| Продакшен | https://api.feedigy.com/v1 |
Создайте токен в разделе Настройки → API. Передавайте его как `Authorization: Bearer <token>`. Без cookie и без CSRF.
Аккаунт
GET /me
Право токена: account:read
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | object | |
data.id | integer | |
data.email | string | |
data.plan | string | null | |
data.limits | object | |
data.limits.api_requests_per_minute | integer | null |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
Фиды
GET /feeds
Право токена: feeds:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
type | query | string | Типы фидов через запятую: original, smart, discovery, imported. |
status | query | "active" | "inactive" | Статус фида. |
search | query | string | Поиск подстроки в названиях фидов. |
tag | query | string | ID своих тегов через запятую (от 1 до 50). |
cursor | query | string | Непрозрачный подписанный курсор из meta предыдущей страницы. Для первой страницы не передавайте. |
per_page | query | integer | Размер страницы, от 1 до 100. По умолчанию 25. |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | array<object> | |
data[].id | integer | |
data[].public_id | string | |
data[].title | string | |
data[].slug | string | null | |
data[].type | "original" | "smart" | "discovery" | "imported" | |
data[].status | "active" | "inactive" | |
data[].description | string | null | |
data[].image_url | string | null | |
data[].source_url | string | null | |
data[].source_name | string | null | |
data[].settings | object | null | Статистика каталога Discover (language, per_week, partial, subscribers). Для других типов фидов — null. |
data[].item_count | integer | |
data[].created_at | string | null | |
data[].last_synced_at | string | null | |
data[].tags | array<object> | |
data[].tags[].id | integer | |
data[].tags[].name | string | |
data[].tags[].slug | string | |
data[].tags[].color | string | null | |
meta | object | |
meta.per_page | integer | |
meta.next_cursor | string | null | |
meta.has_more | boolean |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
POST /feeds
Право токена: feeds:write
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
Idempotency-Key (обязательно) | header | string | Обязателен. От 1 до 255 печатных символов ASCII. Повтор ключа возвращает исходный ответ. Другой запрос с тем же ключом — 422. Хранится 24 ч. |
Тело запроса
| Поле | Тип | Описание |
|---|---|---|
title (обязательно) | string | |
slug | string | null | |
description | string | null | |
tag_ids | array<integer> | null | |
image_url | string | null |
Ответ 201
| Поле | Тип | Описание |
|---|---|---|
data | object | |
data.id | string | |
data.public_id | string | |
data.title | string | |
data.slug | string | |
data.type | string | |
data.status | string | |
data.description | string | |
data.image_url | string | null | |
data.source_url | string | null | |
data.source_name | array<any> | null | string | integer | object | |
data.settings | array<any> | null | |
data.item_count | string | |
data.created_at | string | null | |
data.last_synced_at | string | null | |
data.tags | string | object |
Ошибки
400Тело запроса — невалидный JSON.401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.409Запрос с этим ключом идемпотентности ещё выполняется. Подождите секунду и повторите с тем же ключом.413Тело запроса больше лимита 256 КБ.415Запросы на запись должны передавать Content-Type: application/json.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
GET /feeds/{feed}
Право токена: feeds:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
feed (обязательно) | path | integer |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | object | |
data.id | integer | |
data.public_id | string | |
data.title | string | |
data.slug | string | null | |
data.type | "original" | "smart" | "discovery" | "imported" | |
data.status | "active" | "inactive" | |
data.description | string | null | |
data.image_url | string | null | |
data.source_url | string | null | |
data.source_name | string | null | |
data.settings | object | null | Статистика каталога Discover (language, per_week, partial, subscribers). Для других типов фидов — null. |
data.item_count | integer | |
data.created_at | string | null | |
data.last_synced_at | string | null | |
data.tags | array<object> | |
data.tags[].id | integer | |
data.tags[].name | string | |
data.tags[].slug | string | |
data.tags[].color | string | null |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
PATCH /feeds/{feed}
Право токена: feeds:write
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
feed (обязательно) | path | integer | |
Idempotency-Key (обязательно) | header | string | Обязателен. От 1 до 255 печатных символов ASCII. Повтор ключа возвращает исходный ответ. Другой запрос с тем же ключом — 422. Хранится 24 ч. |
Тело запроса
| Поле | Тип | Описание |
|---|---|---|
title | string | |
slug | string | |
description | string | null | |
status | "active" | "inactive" | |
tag_ids | array<integer> | null | |
image_url | string | null |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | array<any> |
Ошибки
400Тело запроса — невалидный JSON.401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.409Запрос с этим ключом идемпотентности ещё выполняется. Подождите секунду и повторите с тем же ключом.413Тело запроса больше лимита 256 КБ.415Запросы на запись должны передавать Content-Type: application/json.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
DELETE /feeds/{feed}
Право токена: feeds:write
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
feed (обязательно) | path | integer | |
Idempotency-Key | header | string | Необязателен. Если передан, семантика та же, что у POST/PATCH. Без него повторный DELETE видит уже удалённую запись как 404. |
Ответ 204 (без тела)
Ошибки
400Тело запроса — невалидный JSON.401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.409Запрос с этим ключом идемпотентности ещё выполняется. Подождите секунду и повторите с тем же ключом.413Тело запроса больше лимита 256 КБ.415Запросы на запись должны передавать Content-Type: application/json.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
Элементы фида
GET /feeds/{feed}/items
Право токена: feeds:read
Элементы личного фида (original) дополнительно требуют право posts:read.
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
feed (обязательно) | path | integer | |
cursor | query | string | Непрозрачный подписанный курсор из meta предыдущей страницы. Для первой страницы не передавайте. |
per_page | query | integer | Размер страницы, от 1 до 100. По умолчанию 25. |
Ответ 200 (без тела)
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
Посты
GET /posts
Право токена: posts:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
feed | query | integer | Ограничить одним своим личным фидом. |
status | query | "published" | "scheduled" | "draft" | Статус поста. |
cursor | query | string | Непрозрачный подписанный курсор из meta предыдущей страницы. Для первой страницы не передавайте. |
per_page | query | integer | Размер страницы, от 1 до 100. По умолчанию 25. |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | array<object> | |
data[].id | integer | null | Null для строк снимка умного фида: у них нет id в базе, устойчивый идентификатор там — `guid`. |
data[].feed_id | integer | |
data[].guid | string | |
data[].title | string | null | |
data[].slug | string | null | |
data[].status | "published" | "scheduled" | "draft" | |
data[].url | string | null | |
data[].original_url | string | null | |
data[].description | string | null | |
data[].body | string | null | |
data[].image_url | string | null | |
data[].source_title | string | null | |
data[].source_url | string | null | |
data[].author | string | null | |
data[].categories | array<string> | null | |
data[].published_at | string | null | |
data[].scheduled_at | string | null | |
data[].created_at | string | null | |
data[].updated_at | string | null | |
meta | object | |
meta.per_page | integer | |
meta.next_cursor | string | null | |
meta.has_more | boolean |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
POST /posts
Право токена: posts:write
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
Idempotency-Key (обязательно) | header | string | Обязателен. От 1 до 255 печатных символов ASCII. Повтор ключа возвращает исходный ответ. Другой запрос с тем же ключом — 422. Хранится 24 ч. |
Тело запроса
| Поле | Тип | Описание |
|---|---|---|
feed_id (обязательно) | integer | |
title (обязательно) | string | |
slug | string | null | |
body | string | null | |
author | string | null | |
tag_ids | array<integer> | null | |
image_url | string | null | |
status (обязательно) | "published" | "scheduled" | "draft" | |
scheduled_at | string |
Ответ 201
| Поле | Тип | Описание |
|---|---|---|
data | object | |
data.id | string | |
data.feed_id | string | |
data.guid | string | |
data.title | string | |
data.slug | string | |
data.status | string | |
data.url | string | null | |
data.original_url | string | null | |
data.description | string | |
data.body | string | |
data.image_url | string | null | |
data.source_title | string | |
data.source_url | string | null | |
data.author | string | |
data.categories | string | |
data.published_at | string | null | |
data.scheduled_at | string | null | |
data.created_at | string | null | |
data.updated_at | string | null | |
data.feed | object | null | object | |
data.tags | string | object |
Ошибки
400Тело запроса — невалидный JSON.401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.409Запрос с этим ключом идемпотентности ещё выполняется. Подождите секунду и повторите с тем же ключом.413Тело запроса больше лимита 256 КБ.415Запросы на запись должны передавать Content-Type: application/json.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
GET /posts/{post}
Право токена: posts:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
post (обязательно) | path | integer |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | object | |
data.id | integer | null | Null для строк снимка умного фида: у них нет id в базе, устойчивый идентификатор там — `guid`. |
data.feed_id | integer | |
data.guid | string | |
data.title | string | null | |
data.slug | string | null | |
data.status | "published" | "scheduled" | "draft" | |
data.url | string | null | |
data.original_url | string | null | |
data.description | string | null | |
data.body | string | null | |
data.image_url | string | null | |
data.source_title | string | null | |
data.source_url | string | null | |
data.author | string | null | |
data.categories | array<string> | null | |
data.published_at | string | null | |
data.scheduled_at | string | null | |
data.created_at | string | null | |
data.updated_at | string | null |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
PATCH /posts/{post}
Право токена: posts:write
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
post (обязательно) | path | integer | |
Idempotency-Key (обязательно) | header | string | Обязателен. От 1 до 255 печатных символов ASCII. Повтор ключа возвращает исходный ответ. Другой запрос с тем же ключом — 422. Хранится 24 ч. |
Тело запроса
| Поле | Тип | Описание |
|---|---|---|
feed_id | integer | |
title | string | |
slug | string | |
body | string | null | |
author | string | null | |
tag_ids | array<integer> | null | |
image_url | string | null | |
status | "published" | "scheduled" | "draft" | |
scheduled_at | string |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | array<any> |
Ошибки
400Тело запроса — невалидный JSON.401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.409Запрос с этим ключом идемпотентности ещё выполняется. Подождите секунду и повторите с тем же ключом.413Тело запроса больше лимита 256 КБ.415Запросы на запись должны передавать Content-Type: application/json.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
DELETE /posts/{post}
Право токена: posts:write
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
post (обязательно) | path | integer | |
Idempotency-Key | header | string | Необязателен. Если передан, семантика та же, что у POST/PATCH. Без него повторный DELETE видит уже удалённую запись как 404. |
Ответ 204 (без тела)
Ошибки
400Тело запроса — невалидный JSON.401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.409Запрос с этим ключом идемпотентности ещё выполняется. Подождите секунду и повторите с тем же ключом.413Тело запроса больше лимита 256 КБ.415Запросы на запись должны передавать Content-Type: application/json.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
Каналы
GET /channels
Право токена: channels:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
cursor | query | string | Непрозрачный подписанный курсор из meta предыдущей страницы. Для первой страницы не передавайте. |
per_page | query | integer | Размер страницы, от 1 до 100. По умолчанию 25. |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | array<object> | |
data[].id | integer | |
data[].public_id | string | |
data[].channel_id | string | null | |
data[].provider | string | |
data[].name | string | |
data[].avatar_url | string | null | |
data[].public_url | string | null | |
data[].target_kind | string | null | |
data[].capabilities | array<string> | |
data[].connected_at | string | null | |
data[].needs_reconnect | boolean | |
data[].verified | boolean | null | |
data[].overage_disabled | boolean | |
meta | object | |
meta.per_page | integer | |
meta.next_cursor | string | null | |
meta.has_more | boolean |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
Auto-Publisher
GET /publishers
Право токена: publishers:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
cursor | query | string | Непрозрачный подписанный курсор из meta предыдущей страницы. Для первой страницы не передавайте. |
per_page | query | integer | Размер страницы, от 1 до 100. По умолчанию 25. |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | array<object> | |
data[].id | integer | |
data[].public_id | string | |
data[].name | string | |
data[].status | "draft" | "running" | "paused" | "error" | |
data[].destination | string | |
data[].timezone | string | |
data[].schedule_type | string | |
data[].start_at | string | null | |
data[].stop_at | string | null | |
data[].next_run_at | string | null | |
data[].last_run_at | string | null | |
data[].consecutive_failures | integer | |
data[].created_at | string | null | |
data[].updated_at | string | null | |
data[].feeds_count | integer | |
data[].feeds | array<object> | |
data[].feeds[].id | integer | |
data[].feeds[].public_id | string | |
data[].feeds[].title | string | |
data[].feeds[].image_url | string | null | |
data[].feeds[].source_url | string | null | |
meta | object | |
meta.per_page | integer | |
meta.next_cursor | string | null | |
meta.has_more | boolean |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
GET /publishers/{publisher}
Право токена: publishers:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
publisher (обязательно) | path | integer |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | object | |
data.id | integer | |
data.public_id | string | |
data.name | string | |
data.status | "draft" | "running" | "paused" | "error" | |
data.destination | string | |
data.timezone | string | |
data.schedule_type | string | |
data.start_at | string | null | |
data.stop_at | string | null | |
data.next_run_at | string | null | |
data.last_run_at | string | null | |
data.consecutive_failures | integer | |
data.created_at | string | null | |
data.updated_at | string | null | |
data.feeds_count | integer | |
data.feeds | array<object> | |
data.feeds[].id | integer | |
data.feeds[].public_id | string | |
data.feeds[].title | string | |
data.feeds[].image_url | string | null | |
data.feeds[].source_url | string | null |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.404Такой записи в этом аккаунте нет. Чужой id — это 404, не 403.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
Теги
GET /tags
Право токена: feeds:read
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
cursor | query | string | Непрозрачный подписанный курсор из meta предыдущей страницы. Для первой страницы не передавайте. |
per_page | query | integer | Размер страницы, от 1 до 100. По умолчанию 25. |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
data | array<object> | |
data[].id | integer | |
data[].name | string | |
data[].slug | string | |
data[].color | string | null | |
meta | object | |
meta.per_page | integer | |
meta.next_cursor | string | null | |
meta.has_more | boolean |
Ошибки
401Bearer-токен отсутствует, отозван или истёк.403У токена нет нужного права, или тариф не даёт доступ к API.422Запрос синтаксически верен, но семантически нет. Подделанный, чужой или не совпавший с фильтрами курсор — это invalid_cursor: начните с первой страницы. Повтор ключа идемпотентности с другим запросом — это idempotency_key_reused: на каждую логическую операцию нужен новый ключ.429Бюджет тарифа для токена исчерпан. Подождите столько секунд, сколько в Retry-After.503API выключен или лимитер временно недоступен. Повторите с нарастающей паузой.
Конверт ошибки описан в политиках.
События вебхуков
Каждая доставка — это подписанный POST на ваш канал вебхука. Быстрый старт показывает, как проверить подпись.
channel.token_expired
| Поле | Тип | Описание |
|---|---|---|
event | "channel.token_expired" | |
event_id | string | Устойчивый id «channel.token_expired:<integrationId>:<uuid>»: с префиксом, не голый UUID. Дедупликация по нему: повтор присылает тот же id и то же тело. |
version | integer | Версия содержимого. Ломающее изменение формы выходит новой версией. |
occurred_at | string | Метка времени исходного события в ISO 8601 UTC. |
data | object | |
data.integration | object | |
data.integration.id | integer | |
data.integration.provider | string | |
data.integration.label | string | Безопасная подпись для показа. Никогда не секрет. |
data.reason | string | Внутренний код, например provider_rejected_refresh. |
post.published
| Поле | Тип | Описание |
|---|---|---|
event | "post.published" | |
event_id | string | Устойчивый UUID эпизода публикации. Дедупликация по нему: повтор присылает тот же id и то же тело. |
version | integer | Версия содержимого. Ломающее изменение формы выходит новой версией. |
occurred_at | string | Метка времени исходного события в ISO 8601 UTC. |
data | object | |
data.post | object | |
data.post.id | integer | |
data.post.guid | string | |
data.post.title | string | |
data.post.url | string | null | |
data.post.excerpt | string | null | Отрывок простым текстом, не длиннее 2000 символов. |
data.post.image_url | string | null | |
data.post.author | string | null | |
data.post.published_at | string | null | |
data.post.tags | array<string> | |
data.feed | object | null | |
data.feed.id | integer | |
data.feed.title | string | |
data.feed.url | string | null |
publisher.run.failed
| Поле | Тип | Описание |
|---|---|---|
event | "publisher.run.failed" | |
event_id | string | Устойчивый id «publisher.run.failed:<uuid>»: с префиксом, не голый UUID. Дедупликация по нему: повтор присылает тот же id и то же тело. |
version | integer | Версия содержимого. Ломающее изменение формы выходит новой версией. |
occurred_at | string | Метка времени исходного события в ISO 8601 UTC. |
data | object | |
data.publisher | object | |
data.publisher.id | integer | |
data.publisher.name | string | |
data.publisher.destination | string | |
data.error | object | |
data.error.code | "run_failed" | "credentials_rejected" | |
data.error.message | string | |
data.consecutive_failures | integer | |
data.occurrence_id | integer | null |
Keep posting through busy weeks
Set sources, keywords and posting hours once. Feedigy posts to your channels while you work on other things.
No card required. The Free plan has no time limit.
