Быстрый старт API
Полный контракт — openapi.json (OpenAPI 3.1). Эта страница
за десять минут проводит от нуля до проверенного вебхука, только через
curl. Числа и правила (лимиты, ошибки, идемпотентность, гарантии
доставки, версии) — в policies.md.
Базовый URL: https://api.feedigy.com/v1. Каждый запрос требует bearer-токен.
Каждый ответ несёт request_id для разбора в поддержке: в теле ошибки
при сбое и в заголовке X-Request-Id при успехе. Сохраните его.
По нему поддержка найдёт любой вызов.
1. Создайте токен
В приложении откройте Настройки → API (/settings?tab=api), задайте токену
имя, отметьте нужные права (feeds:read, posts:write, …) и скопируйте
bearer. Его показывают один раз: в списке настроек хранятся только
последние четыре символа. Если ничего не отмечено, токен получает права
на чтение явным списком. Подстановки «все права» нет.
export API=https://api.feedigy.com/v1export TOKEN=your-token-here2. Проверьте аккаунт
curl -s $API/me -H "Authorization: Bearer $TOKEN"{ "data": { "id": 7, "email": "you@example.com", "plan": "pro", "limits": { "api_requests_per_minute": 180 } } }limits.api_requests_per_minute всегда совпадает с заголовком ответа
X-RateLimit-Limit (безлимитные тарифы показывают защитный потолок 3000,
не null). Тариф без доступа к API отвечает здесь 403, не 429.
3. Получите список фидов
curl -s "$API/feeds?status=active&per_page=5" -H "Authorization: Bearer $TOKEN"{ "data": [ … ], "meta": { "per_page": 5, "next_cursor": "eyJ…", "has_more": true } }Пагинация курсорная: передайте meta.next_cursor как ?cursor= для
следующей страницы. per_page по умолчанию 25, максимум 100. Неизвестный
ключ запроса — это 422, его не пропускают молча. Опечатка в фильтре
вернётся ошибкой.
4. Создайте пост (идемпотентно)
Запись требует Content-Type: application/json и, для POST/PATCH, заголовок
Idempotency-Key (от 1 до 255 печатных символов ASCII, хранится 24 ч).
Повтор ключа возвращает исходный ответ и ничего не пишет заново.
Платформы автоматизации повторяют запросы агрессивно, поэтому на одну
логическую операцию нужен один ключ (подходит UUID), и его же надо
передавать при повторах:
export KEY=$(php -r 'echo Ramsey\Uuid\Uuid::uuid4()->toString();' 2>/dev/null || python3 -c 'import uuid; print(uuid.uuid4())')curl -s -X POST $API/posts \ -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ -H "Idempotency-Key: $KEY" \ -d '{"feed_id": 12, "title": "Hello, API", "status": "draft"}' -D -Ответ 201 содержит пост и заголовок Location. Тот же запрос ещё раз
даёт тот же 201 с тем же телом: один пост, не два. Другое тело с тем же
ключом даёт 422: новой логической операции нужен новый ключ.
status бывает draft, scheduled (с меткой scheduled_at и явным
смещением) или published. Неизвестное поле тела — это 422.
5. Примите вебхук post.published
В Настройки → API добавьте endpoint: ваш публичный HTTPS-адрес с
подпиской на post.published, и скопируйте одноразовый секрет. Опубликуйте
черновик из шага 4 (в приложении или PATCH /v1/posts/{id} с
{"status":"published"}). Приёмник получит:
POST /your-path Content-Type: application/jsonX-Feedigy-Event: post.publishedX-Feedigy-Delivery: <per-endpoint delivery id, an integer>X-Feedigy-Timestamp: <unix seconds>X-Feedigy-Signature: t=<ts>,v1=<hex HMAC-SHA256>{ "event": "post.published", "event_id": "<publication episode UUID>", "version": 1, "occurred_at": "2026-10-09T…Z", "data": { "post": { "id": 99, "title": "Hello, API", … }, "feed": { "id": 12, "title": "…", … } } }Проверяйте подпись до разбора тела: HMAC-SHA256 от
<timestamp>.<точное сырое тело> с вашим секретом, hex в нижнем регистре,
сравнение за постоянное время. Отклоняйте метки времени вне окна 5 минут.
Храните id из X-Feedigy-Delivery: доставка как минимум один раз, поэтому
повтор присылает тот же id и то же тело. В течение 24 ч после смены секрета
приходят и текущая, и предыдущая подпись
(t=<ts>,v1=<current>,v1=<previous>). Принимайте любую.
$raw = file_get_contents('php://input');$timestamp = null;$signatures = [];foreach (explode(',', $_SERVER['HTTP_X_FEEDIGY_SIGNATURE'] ?? '') as $part) { [$k, $v] = array_pad(explode('=', $part, 2), 2, ''); if ($k === 't') { $timestamp = $v; } elseif ($k === 'v1' && $v !== '') { $signatures[] = $v; // after a rotation there are two; accept either }}$okAge = $timestamp !== null && abs(time() - (int) $timestamp) <= 300;$expected = hash_hmac('sha256', ($timestamp ?? '').'.'.$raw, $secret);$okSig = false;foreach ($signatures as $sig) { if (strlen($sig) === strlen($expected) && hash_equals($expected, $sig)) { $okSig = true; }}if (! $okAge || ! $okSig) { http_response_code(401); exit;}// …then dedupe on X-Feedigy-Delivery and process $raw…(Принимайте любое значение v1= в заголовке: после смены секрета их два.
Эталонный приёмник в deploy/webhook-reference-consumer делает ту же
проверку на Node.)
Два других события устроены так же: publisher.run.failed (плановый запуск
Auto-Publisher завершился окончательной ошибкой) и channel.token_expired
(подключённый аккаунт нужно переподключить). Формы содержимого —
WebhookPostPublished, WebhookPublisherRunFailed и
WebhookChannelTokenExpired в openapi.json.
Что дальше
- Политики API — лимиты и тарифы, конверт ошибки, семантика идемпотентности, гарантии доставки, версии.
- Спецификация OpenAPI — машинный контракт.
- Справочник API — каждый endpoint, поле и событие вебхука.
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.
