Эндпоинт

Отправьте тело запроса в JSON, а ключ передайте в заголовке X-API-KEY (не Authorization: Bearer).

Имена полей — в camelCase, в запросах и ответах: clubId, createdAt. Имя с подчёркиванием, например club_id, отклоняется с кодом 400 PUBLIC_API_SNAKE_CASE_FIELD, а ответ называет поле, которое нужно отправить вместо него.

contentstring

текст поста, от 1 до 2000 символов. Обязательное поле.

clubIduuid | null

клуб, от имени которого публикуете. Необязательное поле — без него пост попадёт в вашу личную ленту.

curl -X POST https://api.amator.app/api/v1/public/posts \
  -H "X-API-KEY: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"content":"Training moved to 19:00 tonight"}'

Успешная публикация возвращает 201 и ссылку на пост:

HTTP/1.1 201 Created

{
  "success": true,
  "data": {
    "id": "…",
    "destination": "club",
    "clubId": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-10-05T18:00:00.000Z",
    "url": "https://amator.app/posts/…",
    "media": []
  },
  "requestId": "…"
}

ФотоСкопировать ссылку на раздел

Чтобы опубликовать фото, отправьте те же поля как multipart/form-data вместо JSON и добавьте до 4 файлов в поле photos — они появятся в том порядке, в котором вы их отправили. Только текст, только фото или всё вместе: content можно не передавать, если отправлено хотя бы одно фото.

photosфайл, до 4

JPEG, PNG или WebP, до 5 МБ каждое. Без видео.

curl -X POST https://api.amator.app/api/v1/public/posts \
  -H "X-API-KEY: YOUR_API_KEY_HERE" \
  -H "Idempotency-Key: 9b2f6d4e-1c3a-4f5b-8e7d-2a1c0b9f8e7d" \
  -F content="Match day! Kick-off at 18:00" \
  -F clubId=00000000-0000-0000-0000-000000000000 \
  -F photos=@a.jpg \
  -F photos=@b.jpg

Ограничения: 40 фото в сутки на один API-ключ; весь запрос — не больше 4 фото и текста. Всё или ничего: если что-то не удалось, ни одно фото не сохраняется и ничего не публикуется. Отправьте заголовок Idempotency-Key (UUID) — и повтор после тайм-аута вернёт первый пост, а не опубликует его второй раз.

Другие ответыСкопировать ссылку на раздел

• 400FEED_POST_EMPTY

  Текст поста пустой или слишком длинный.

• 400PUBLIC_API_SNAKE_CASE_FIELD

  Имя поля с подчёркиванием, например club_id: details.fields называет поле в camelCase, которое нужно отправить (clubId).

• 401PUBLIC_API_KEY_INVALID

  Ключ не передан, неизвестен или отозван.

• 403FEED_NOT_A_CAPTAIN

  Вы не владелец и не администратор этого клуба.

• 404FEED_TEAM_NOT_FOUND

  Клуба с таким clubId не существует.

• 429PUBLIC_API_RATE_LIMITED

  В этот час в это место уже был опубликован пост.

• 429FEED_DAILY_LIMIT_REACHED

  Исчерпан дневной лимит ленты — 40 постов в день.

• 400PUBLIC_API_TOO_MANY_PHOTOS

  Больше 4 фото в одном посте.

• 400IMAGE_INVALID_FILE_TYPE

  Фото не в формате JPEG, PNG или WebP — например, видео.

• 400IMAGE_FILE_TOO_LARGE

  Фото больше 5 МБ.

• 400PUBLIC_API_MULTIPART_INVALID

  Форму не удаётся прочитать — файл вне photos или поле, отправленное дважды.

• 413PUBLIC_API_BODY_TOO_LARGE

  Запрос больше, чем 4 фото и текст.

• 429PUBLIC_API_PHOTO_DAILY_LIMIT

  Этот API-ключ уже опубликовал свои 40 фото за последние 24 часа.