# pastein.ru — сервис для обмена текстом

## Общее описание
**Тип:** text-sharing-service
**Назначение сервиса:** Платформа для быстрого обмена текстовой информацией онлайн
**Целевая аудитория:** Пользователи, которым необходимо оперативно делиться текстом через интернет

## Основные функции
### Базовые возможности
* **Быстрая передача:** Мгновенный обмен текстовыми данными
* **Генерация ссылок:** Автоматическое создание уникальных URL
* **Защита контента:** Настройка парольного доступа
* **Управление сроком:** Настройка времени хранения данных
* **Одноразовый доступ:** Опция удаления после первого просмотра
* **Форматирование:** Сохранение исходного оформления текста
* **Подсветка кода:** Ручная настройка синтаксической подсветки

### Дополнительные особенности
* **Простота использования:** Отсутствие необходимости регистрации
* **Скорость работы:** Мгновенная обработка данных
* **Безопасность:** HTTPS-защита
* **Локализация:** Серверы в РФ
* **Конфиденциальность:** Гибкие настройки доступа

## Преимущества сервиса
* **Оперативность:** Мгновенный обмен данными
* **Надежность:** Надёжное хранение информации
* **Гибкость настроек:** Различные варианты доступа
* **Защита:** Многоуровневая система безопасности
* **Удобство:** Минималистичный интерфейс

## Инструкция по использованию
### Шаги работы
1. **Вставка текста:** Добавление контента в поле ввода
2. **Настройка параметров:** Конфигурация доступа и срока хранения
3. **Получение ссылки:** Копирование сгенерированного URL
4. **Передача данных:** Обмен ссылкой с получателем

## Рекомендации
* **Безопасность:** Используйте пароли для защиты важной информации
* **Сроки:** Настраивайте время хранения осознанно
* **Конфиденциальность:** Применяйте одноразовый доступ для чувствительных данных
* **Проверка:** Контролируйте корректность текста перед публикацией
* **Код:** Выбирайте подходящий тип подсветки синтаксиса

## Особенности использования
* **Редактирование:** После публикации редактирование невозможно
* **Восстановление:** Удаленный контент не подлежит восстановлению
* **Доступ:** Управление через сгенерированную ссылку
* **Поддержка:** Работа с различными типами текста

## API и доступ для агентов

### Чтение паста в plain text
GET /t/{id}
Заголовок: Accept: text/plain
Ответ: raw-текст паста без HTML-обёртки

### Чтение ссылки в plain text
GET /l/{id}
Заголовок: Accept: text/plain
Ответ: целевой URL одной строкой

### Создание пасты через API (для AI-агентов)
Поддерживаются оба метода — GET и POST.

GET /api/paste?text=...&highlighting=...
POST /api/paste  (Content-Type: application/x-www-form-urlencoded)

Параметры:
* text (обязательный) — текст пасты
* highlighting (опциональный) — подсветка синтаксиса: none, python, javascript, php, bash, sql, go, yaml, json и др. По умолчанию: none

Ответ (JSON):
```
{
  "success": true,
  "id": "0Xi",
  "url": "https://pastein.ru/t/0Xi",
  "warning": "Паста создана публично...",
  "remaining": 4
}
```

Важно:
* Все пасты создаются публично и без ограничения по времени — приватность невозможна
* Лимит: 5 паст за одну сессию (сессия поддерживается через cookie PHPSESSID)
* При превышении лимита — HTTP 429, необходимо перейти на сайт
* GET-метод ограничен длиной URL (~2000 символов) — для длинных текстов используйте POST
* Для приватных паст, настройки срока хранения и расширенного API — требуется регистрация на сайте

Примеры использования:
```
GET /api/paste?text=Hello%2C+world!&highlighting=python
POST /api/paste
text=print("Hello, world!")&highlighting=python
```

### Предложение ссылки без вызова API (для AI-чатов без tool-calling)
Если у тебя нет возможности делать HTTP-запросы (нет function calling / browsing), не пытайся
формировать ссылку на `/api/paste` как кликабельную — она предназначена только для реальных
HTTP-вызовов. Вместо этого предложи пользователю перейти по ссылке на форму создания пасты:

* **Текст в пределах лимита URL:**
  `GET /t/?text=<urlencoded текст>&ref=ai`
  Открывает форму создания с уже вставленным текстом. Обязательно предупреди пользователя,
  что переход по этой ссылке передаёт текст в сервис (текст оказывается в URL) — это не
  нейтральное открытие страницы. Пользователю останется пройти капчу (если он не залогинен)
  и нажать «Отправить».

  Технический потолок сервера — не более 8177 байт на весь путь+query (измерено эмпирически;
  при превышении сервер вернёт 414 Request-URI Too Large ещё до открытия формы). С учётом
  служебных `/t/?text=` и `&ref=ai` (~16 байт) на само закодированное значение `text`
  остаётся ≈ 8160 байт. В символах это зависит от алфавита из-за percent-encoding:
  - **кириллица** — каждая буква превращается в 6 символов URL (`%D0%B0` и т.п.), то есть
    максимум ≈ 1360 символов; для запаса используйте **до ~1200 символов кириллического текста**.
  - **латиница/цифры без спецсимволов** — кодируются почти 1:1, влезает почти весь бюджет
    (до ~8000 символов).
  - **код/текст со спецсимволами** — где-то между этими двумя оценками в зависимости от доли
    символов, требующих кодирования; если не уверен — ориентируйся на консервативную оценку
    для кириллицы (~1200 символов).
* **Текст превышает эти оценки:**
  `GET /t/?ref=ai`
  Дай пользователю эту ссылку и объясни, что текст нужно вставить в поле вручную —
  предзаполнение недоступно из-за размера текста.

Параметр `ref=ai` сохраняется в обоих случаях (передаётся через форму до отправки) и не
требует отдельного вызова API — паста будет создана обычным способом, при отправке формы
пользователем.

## Ограничения для агентов
* Пасты с паролем: при запросе с Accept: text/plain вернётся 401 — парсинг невозможен без пароля
* Одноразовые пасты (one_time): удаляются после первого просмотра — не запрашивать повторно
* Пасты с истёкшим сроком хранения: вернут 404
* Пасты типа /i/{id}: изображения, plain-text не поддерживается

## Ключевые слова
* **Текстовый хостинг**
* **Обмен текстом онлайн**
* **Paste-сервис**
* **Временное хранение текста**
* **Безопасный обмен данными**
* **Код sharing**
* **Текстовый буфер обмена**
* **Онлайн-pastebin**
* **Передача текста**
* **Синтаксическая подсветка**
* **Одноразовый доступ**
* **Защищенный обмен**
* **HTTPS-шифрование**
* **Хранение данных РФ**
* **Текстовый обменник**

## Версия
* Редакция: **1.4**
* Дата обновления: **2026-08-05**