API-ключ, аккаунт и кредиты запросов

Зарегистрируйтесь и сохраните ключ перед уходом

Создайте аккаунт с адресом электронной почты и паролем длиной 12–72 байта в UTF-8. Байты не всегда соответствуют количеству видимых символов. Регистрация использует почту и пароль; вход через Google и подключение кошелька недоступны. Функции сброса пароля сейчас нет, поэтому храните пароль надёжно.

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

Ключ и баланс для этого домена

Используйте сохранённый ключ с https://api.redditapp.com через X-API-Key или Authorization: Bearer. Не включайте его в мобильный бинарный файл, браузерную сборку, URL или публичный отчёт об ошибке. Ваш бэкенд выполняет аутентифицированные запросы к архиву от имени приложения. Сессия аккаунта на этой странице отделена от этих заголовков запроса.

Аккаунты, балансы и ключи принадлежат этому домену. Ключ другого сайта сети здесь не работает. Подходящая под условия регистрация может получить 100 пробных кредитов с учётом общих для сети проверок почты и исходного IP на злоупотребления. Пробные кредиты условны: это не обещание бесплатного доступа и не дополнение к каждому платному пополнению.

Считайте запросы, а не записи

Один кредит оплачивает один успешный запрос данных, включая успешный ответ без записей. $1 соответствует 1000 платных кредитов; минимальное пополнение $50 даёт 50 000 платных кредитов. Возвращены три записи или 100 — цена запроса остаётся равной одному кредиту. Подписки нет, срок действия платных кредитов не ограничен.

Неверные запросы, отклонённые до резервирования, не списывают кредит. При сбое вышестоящего запроса зарезервированный кредит освобождается, хотя возврат может ожидать сверки. Открытый ответ /v1/status не тарифицируется и не проверяет поисковый бэкенд. Сверяя расход, учитывайте баланс и счётчики успешных, ожидающих и возвращённых запросов в аккаунте.

Создайте счёт до перевода средств

Войдите здесь в аккаунт и создайте счёт на сумму, которую хотите внести. Поддерживаются USDT в сети TRON TRC20 и USDC в основной сети Ethereum ERC20. Используйте адрес получателя, точную сумму к оплате, токен и сеть из этого серверного счёта. Сохраняйте все показанные десятичные знаки: сумма к оплате может содержать небольшой идентификационный суффикс.

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

Проверьте перевод и прочитайте фактическое состояние

Отправив указанный перевод, вставьте его хеш транзакции в поле проверки счёта. Только подлинный подходящий перевод, подтверждённый сервером, меняет счёт на оплаченный и добавляет кредиты. Ожидание, недоступность провайдера проверки или один лишь хеш транзакции не подтверждают оплату. Не отправляйте второй перевод только потому, что проверка временно недоступна.

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

Если ключ потерян, замените его осознанно

Пользователь, вошедший в аккаунт, может ввести пароль и создать новый API-ключ. Регенерация немедленно делает старый ключ недействительным, поэтому подготовьтесь обновить все использующие его развёртывания бэкенда. Сохраните новый полный ключ при показе, замените прежний секрет и проверьте результат отдельным запросом. Регенерация не восстанавливает и не отправляет по почте предыдущий ключ.

Первый иллюстративный запрос разобран в разделе «Разработка функции», а оценка собственного расхода — в заметке «Бюджет поисковой функции приложения». Эти примеры не подтверждают работающую интеграцию или наличие конкретных данных в архиве.