Inbox API

Отправляйте готовые markdown-дайджесты от внешних агентов (Claude, Cursor и др.) прямо во входящие Nitrod. Без AI-обработки и без списания токенов — контент сохраняется как есть.

1. Получите API-ключ

В личном кабинете откройте Настройки пространства → блок API для входящих → «Сгенерировать ключ». Ключ привязан к одному пространству. При компрометации — «Обновить ключ» или «Отключить».

2. Эндпоинт

POST https://www.nitrod.ru/api/inbox

3. Заголовки

Authorization: Bearer <ваш_api_ключ>

Content-Type: application/json

Accept: application/json

4. Тело запроса (JSON)

{
  "content": "# Яппинг — гайд\n\nMarkdown-текст дайджеста...",
  "title": "Яппинг — гайд по разговору на камеру",
  "tags": ["youtube", "дайджест", "контент"]
}

content — обязательно. Markdown-текст (до 500 000 символов).
title — необязательно. Если не указан, берётся первый # заголовок или первая строка.
tags — необязательно. Массив меток (до 50). Создаются как теги заметки.

5. Пример curl

curl -X POST "https://www.nitrod.ru/api/inbox" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "content": "# Саммари видео\n\nКраткое содержание...",
    "tags": ["youtube", "саммари"]
  }'

6. Успешный ответ (201)

{
  "data": {
    "id": "01h...",
    "space_id": "01k...",
    "title": "Саммари видео",
    "status": "inbox",
    "source_type": "api",
    "raw_text": "...",
    "ai_summary": "...",
    "processing_status": "completed",
    "created_at": "2026-06-19T07:00:00+00:00",
    "updated_at": "2026-06-19T07:00:00+00:00",
    "tags": [
      { "id": "01t...", "name": "youtube" }
    ]
  },
  "message": "Запись добавлена во входящие"
}

7. Ошибки

Код	Описание
401	Ключ не указан или недействителен
422	Ошибка валидации (например, пустой `content`)
429	Превышен лимит: 30 запросов в минуту на ключ

8. Уведомления

После успешной отправки участники пространства получают уведомление: колокольчик в дэшборде и подключённые каналы (Telegram, Max, Pushover) — согласно настройкам в разделе «Коннекторы».

Полный REST API

Для мобильного приложения и интеграций с авторизацией пользователя доступен REST API с Sanctum-токеном (POST /api/auth/token). Inbox API — отдельный упрощённый канал только для записи во входящие по ключу пространства.