Два маршрути відповідають на різні запитання
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. Використовуйте отримувача й точну суму поточного рахунку, потім надішліть хеш транзакції на перевірку. Гарантій строку зарахування або постійної доступності архіву немає.
