К содержанию
стекai

Авторам

API для публикации постов

Если пост готовится не в браузере, а в своём скрипте или редакции, его можно отправить запросом. На сайте он появится после той же модерации, что и форма «Написать».

Что нужно заранее

  1. Аккаунт на stekai.ru.
  2. Ключ в настройках профиля. Он показывается один раз, в ответе API его нет.
  3. Согласие с правилами сообщества: в каждом запросе поле acceptRules: true.

Отправить пост

POST https://stekai.ru/api/v1/posts

Заголовок Authorization: Bearer stk_… и JSON:

  • title — от 10 до 140 символов
  • lead — от 30 до 300 символов
  • body — от 300 до 30 000 символов, разметка как в форме
  • category — tekst, izobrazheniya, video, audio, kod, rabota, industriya
  • acceptRules — строго true
curl -X POST https://stekai.ru/api/v1/posts \
  -H "Authorization: Bearer stk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Как я собрал отчёт в Claude за вечер",
    "lead": "Коротко: какая была задача, что сработало и какой кусок промпта можно забрать себе.",
    "body": "Текст от 300 символов. Подзаголовки — строкой ## , промпт — между строками ~~~.",
    "category": "rabota",
    "acceptRules": true
  }'

Успех — ответ 201 с id и status: "pending". Ссылка появится в поле url, когда модератор опубликует пост.

Посмотреть свои посты

GET /api/v1/posts — список своих постов и статусы. Фильтр: ?status=pending, approved или rejected.

GET /api/v1/posts/123 — один свой пост вместе с текстом. Чужой номер вернёт 404.

GET /api/v1/categories — рубрики, ключ не нужен.

Лимиты

  • Не больше 3 постов одновременно на модерации.
  • Не больше 10 постов в сутки с одного аккаунта. Форма на сайте входит в тот же счёт.
  • Не больше 5 действующих ключей. Лишний отзывается в настройках, после этого он перестаёт работать сразу.

Почта, пароль и сам ключ в ответы не попадают. Запрос идёт с сервера автора: из браузера чужого сайта API не открыт.