goglink REST API

goglink — это высокопроизводительный сервис постоянных ссылок-редиректов для 18-месячных подписок Google Gemini Advanced.

Активационные ссылки Google (serviceactivation.google.com) имеют жесткий криптографический TTL 30 минут. Сервис goglink предоставляет покупателям и ботам постоянные ссылки вида https://gog.example.com/<slug>, которые непрерывно в фоне перенаправляются на свежий живой токен, автоматически генерируемый из пула активных Jio-сессий.

🔑 Ваш API-ключ для песочницы:

Аутентификация

API защищён секретным ключом. Вы можете передавать ключ любым из трёх способов:

Заголовок X-Api-Key: <API_KEY> (Рекомендуется)
Заголовок Authorization: Bearer <API_KEY>
URL query-параметр: ?key=<API_KEY> (Удобно для браузерного скачивания файлов)

Пример: curl -H "X-Api-Key: YOUR_API_KEY" https://pnl.example.com/api/stats

Хосты и домены

Домен	Назначение
`https://gog.example.com/<slug>`	Постоянные ссылки-редиректы клиентов (HTTP 302 на Google) и экспорт
`https://pnl.example.com/`	Веб-панель администратора и управление API

1. Выгрузка пула ссылок

GET /api/export или /api/links/export

Выгружает пачку ссылок из пула. По умолчанию отдаёт чистый .TXT файл со списком ссылок построчно (удобно для заливки в шопы и боты). Также поддерживает JSON.

Параметры запроса (Query)

Параметр	Тип	По умолчанию	Описание
`limit` (или `count`)	integer опц.	100	Количество ссылок (напр. `101`, `200`, `1011`). Значение `0` выгружает все доступные.
`type`	string опц.	`redirect`	`redirect` — постоянные ссылки `https://gog.../slug` `target` — прямые ссылки Google `https://serviceactivation...` `both` — обе ссылки через разделитель `gog \| google`
`only_valid`	boolean опц.	`1`	`1` — только 100% свежие валидные ссылки (токен <30м, сессия Jio жива). `0` — все ссылки без фильтрации.
`format`	string опц.	`txt`	`txt` (скачиваемый файл с Content-Disposition) или `json` (JSON структура).
`key`	string опц.	—	API-ключ в query для скачивания браузером в 1 клик.

Примеры cURL

# Скачать файл gemini_links_101pcs.txt со 101 ссылкой:
curl -O "https://gog.example.com/api/export?limit=101&key=YOUR_API_KEY"

# Скачать 200 прямых Google ссылок (target):
curl "https://gog.example.com/api/export?limit=200&type=target&key=YOUR_API_KEY" > google_links_200.txt

# Получить в формате JSON:
curl -s "https://gog.example.com/api/export?limit=50&format=json"   -H "X-Api-Key: YOUR_API_KEY"

Тест в браузере: Лимит: Формат:

2. Постоянные ссылки (Links)

GET /api/links

Возвращает список постоянных ссылок из пула со статусом их валидности, временем последнего обновления и состоянием связанной Jio-сессии.

Параметры запроса

Параметр	Тип	Описание
`only_valid`	boolean	`1` — вернуть только свежие валидные ссылки.
`limit`	integer	Лимит записей (напр. `50`).

curl -s https://pnl.example.com/api/links -H "X-Api-Key: YOUR_API_KEY"

Пример ответа

{
  "count": 33,
  "links": [
    {
      "slug": "4ovmir9BRZNHfNz",
      "url": "https://gog.example.com/4ovmir9BRZNHfNz",
      "target": "https://serviceactivation.google.com/subscription/new/AQCpiIH5rGpj...",
      "phone": "6200472567",
      "note": "",
      "created_at": 1792174815,
      "updated_at": 1792232893,
      "age_sec": 75,
      "age_min": 1.2,
      "is_valid": true,
      "session_active": true
    }
  ]
}

POST /api/link

Создаёт новую постоянную ссылку или обновляет существующую по slug.

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

Поле	Тип	Обязательное	Описание
`target`	string	Да	Целевой Google URL (`https://serviceactivation.google.com/...`)
`phone`	string	Опц.	10-значный номер Jio, к которому привязан токен (для автоматического обновления рефрешером)
`slug`	string	Опц.	Пользовательский slug. Если не указан — генерируется автоматически (16 символов).
`note`	string	Опц.	Произвольная заметка (ID заказа, клиент и т.п.)

curl -X POST https://pnl.example.com/api/link   -H "X-Api-Key: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "target": "https://serviceactivation.google.com/subscription/new/AQCpiI...",
    "phone": "9876543210",
    "note": "Покупатель #412"
  }'

Ответ

{
  "slug": "m4XvL89QweRty10",
  "url": "https://gog.example.com/m4XvL89QweRty10"
}

GET /api/link/{slug}

Возвращает подробные метаданные по конкретной ссылке: возраст токена, целевой URL, привязанный телефон, валидность.

curl -s https://pnl.example.com/api/link/4ovmir9BRZNHfNz   -H "X-Api-Key: YOUR_API_KEY"

DELETE /api/link/{slug}

Удаляет постоянную ссылку из пула. При переходе по ней клиенты будут получать 404.

curl -X DELETE https://pnl.example.com/api/link/4ovmir9BRZNHfNz   -H "X-Api-Key: YOUR_API_KEY"

Ответ

{"deleted": 1}

3. Обновление целей (Refresher)

POST /api/refresh

Обновляет целевой Google токен для конкретного slug. Slug и URL для клиента остаются неизменными.

curl -X POST https://pnl.example.com/api/refresh   -H "X-Api-Key: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "slug": "4ovmir9BRZNHfNz",
    "target": "https://serviceactivation.google.com/subscription/new/AQCpiI_NEW_TOKEN..."
  }'

POST /api/refresh_phone

Обновляет целевой токен для всех ссылок, привязанных к указанному номеру телефона Jio. Именно этот метод автоматически вызывает jit_refresher.

curl -X POST https://pnl.example.com/api/refresh_phone   -H "X-Api-Key: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "phone": "6200472567",
    "target": "https://serviceactivation.google.com/subscription/new/AQCpiI_FRESH..."
  }'

4. Пул и автоочистка

GET /api/pool/status

Возвращает детальный статус пула: общее число, количество свежих валидных ссылок, время и результат последней автопроверки.

curl -s https://pnl.example.com/api/pool/status   -H "X-Api-Key: YOUR_API_KEY"

POST /api/pool/cleanup

Запускает внеочередную проверку и очистку пула:
1) Синхронизирует цели из живых сессий Jio.
2) Удаляет ссылки, которые старше 30 минут или сессии которых умерли.

curl -X POST https://pnl.example.com/api/pool/cleanup   -H "X-Api-Key: YOUR_API_KEY"   -H "Content-Type: application/json" -d '{}'

Ответ

{
  "ts": 1792233018,
  "total": 46,
  "valid": 33,
  "purged": 13,
  "refreshed": 12,
  "log": "Проверено 46 ссылок: валидных 33, удалено истекших 13 (обновлено целей: 12) за 0.02s"
}

5. Мониторинг и сессии

GET /api/stats

Сводная статистика всей системы: ссылки в пуле, активные сессии Jio, свежий сток в pixora.db, статус последней автопроверки.

curl -s https://pnl.example.com/api/stats   -H "X-Api-Key: YOUR_API_KEY"

GET /api/sessions

Список сессий Jio в session_store (источники регенерации токенов). Параметры: ?active=1 (только живые), ?limit=100.

curl -s "https://pnl.example.com/api/sessions?active=1&limit=50"   -H "X-Api-Key: YOUR_API_KEY"

GET /api/stock

Список сырых ссылок из таблицы stock (pixora.db).

curl -s https://pnl.example.com/api/stock -H "X-Api-Key: YOUR_API_KEY"

POST /api/stock/take

Атомарно забирает N свежих ссылок из стока и помечает их как проданные (is_sold=1).

curl -X POST https://pnl.example.com/api/stock/take   -H "X-Api-Key: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"n": 5}'

POST /api/job/harvest и /api/job/refresh

Запуск фоновых воркеров сбора новых ссылок с Firebase-панелей или принудительного обновления целей.

curl -X POST https://pnl.example.com/api/job/harvest   -H "X-Api-Key: YOUR_API_KEY"   -H "Content-Type: application/json" -d '{"max": 10}'