Выбор языка

Отделите публичный статус от защищённого поиска по архиву

Разделите проверку HTTP-ответа и платный поиск исторических записей Reddit. Серверный ключ, ограниченная выборка и явный учёт расходов.

Получить API-ключ

Пример запроса

cURL

curl --fail-with-body "https://api.redditgateway.com/v1/status"

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditgateway.com/v1/search?q=database&subreddit=backend&limit=3"

Разные запросы — разные сведения о системе

Reddit Gateway предоставляет серверным командам доступ на чтение к независимому историческому архиву Reddit. Сервис не является официальным продуктом Reddit и не связан с этой платформой. Важная граница интеграции проходит между публичным описанием сервиса и защищённым получением записей. Успешный ответ статуса не доказывает работоспособность поиска, правильность ключа или наличие кредитов на счёте.

GET https://api.redditgateway.com/v1/status не требует ключа и не расходует кредиты. Маршрут возвращает статическое описание исторического архива и подтверждает, что HTTP-приложение отвечает. Он не обращается к поисковой подсистеме, не проверяет доступность записей, не показывает баланс и не измеряет задержку. В собственной панели называйте это наблюдение ответом HTTP, а не зелёным индикатором состояния базы данных.

Ключ для получения данных храните на своём сервере отдельно от публичной проверки. Поддерживаются X-API-Key: <ключ> и Authorization: Bearer <ключ>; достаточно одного из этих заголовков. Это ключ учётной записи архива, а не токен Reddit OAuth. Сервис не предоставляет публикацию, голосование, личные сообщения, текущую ленту или прозрачную пересылку произвольных маршрутов официальной платформы.

Проверьте одну ограниченную поисковую выборку

Начните с GET https://api.redditgateway.com/v1/search?q=database&subreddit=backend&limit=3. Параметр q=database задаёт текстовый поиск, subreddit=backend ограничивает сообщество, а limit=3 запрашивает не более трёх записей. Поиск может вернуть публикации и комментарии. Выбранные параметры не гарантируют наличия материалов, полезного контекста или полного охвата сообщества; отсутствие совпадений не означает, что такого обсуждения никогда не было.

Синтетический фрагмент ответа, только для демонстрации: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Это не результат реального запроса; баланс вымышленный. Сначала сохраните исходный ответ, затем проверьте data и преобразуйте доступные поля. Успешная пустая выборка тоже стоит один кредит. Различайте пустой массив, сетевой сбой и отклонённый ключ, чтобы не запускать одинаковый повтор для разных ситуаций.

Записи плоские, состав полей может различаться. Присутствующие parent_id и link_id позволяют связывать полученные данные локально, но не гарантируют полную беседу или цепочку родителей. Выдача следует внутреннему порядку _doc, а не времени, релевантности или оценке. min_score задаёт числовой порог без сортировки. На запрос доступно до 100 записей, на поисковую выборку — до 100 страниц; обход не доказывает полноту или уникальность.

Согласуйте доступ и расход кредитов

Регистрация по электронной почте и паролю показывает ключ один раз сразу, до оплаты. Пароль должен занимать 12–72 байта UTF-8. Выдача 100 пробных кредитов зависит от общесетевых проверок против злоупотреблений. Проверьте фактически выданный баланс. На странице ключа расположена панель счёта: баланс, создание счетов на оплату и регенерация ключа после подтверждения пароля. Старый ключ при этом сразу перестаёт действовать.

Каждое успешное получение, включая пустое и повторное, стоит один кредит: $1 за 1000 запросов. Минимальное платное пополнение $50 даёт 50000 кредитов. Подписок нет, купленные кредиты не истекают. Некорректные запросы не списывают баланс; сбой источника возвращает резерв. Потеря ответа клиентом может произойти после оплаченного успеха, а новый успешный запрос оплачивается снова.

Документация описывает маршруты, руководство — ограничения доступа в вашем приложении, страница цен — расчёт расходов. Перед переводом войдите и создайте счёт. Поддерживаются USDT в TRON TRC20 и USDC ERC20 в основной сети Ethereum. Используйте получателя и точную сумму текущего счёта, затем отправьте хеш транзакции на проверку. Гарантий срока зачисления или постоянной доступности архива нет.