gcookie-api

HTTP-API генератора наборов кук.

Авторизация

Все эндпоинты, кроме /health и этой страницы, требуют токен. Передавайте его одним из двух способов:

заголовком X-Api-Token: <ТОКЕН>
параметром строки запроса ?token=<ТОКЕН> (удобно открывать прямо в браузере)

Без токена или с неверным — ответ 401.

Эндпоинты

Метод	Путь	Токен	Назначение
GET	`/`	нет	эта документация
GET	`/health`	нет	`{"ok":true}`
GET	`/generate`	да	сгенерировать наборы
GET	`/stats`	да	метрики соответствия закономерностям

GET /generate

Параметр	По умолч.	Описание
`n`	100	число строк, 1..200000
`seed`	случайный	целое — повторяемый результат
`mode`	exact	`exact` — точная раскладка долей по таблицам разбора; `approx` — взвешенная выборка
`format`	txt	`txt` — по строке на набор; `json` — `{count, mode, seed, lines[]}`
`download`	0	`1` — отдать файлом (вложение)

Ответ txt — литералы словарей Python (одинарные кавычки), по строке на набор.

# открыть в браузере (100 строк)
https://g.topfingers.online/generate?token=ВАШ_ТОКЕН

# 1000 строк с фикс. seed, скачать файлом
https://g.topfingers.online/generate?n=1000&seed=7&download=1&token=ВАШ_ТОКЕН

# curl, заголовком
curl -H "X-Api-Token: ВАШ_ТОКЕН" \
  "https://g.topfingers.online/generate?n=500&format=json"

GET /stats

Генерирует набор (n, seed, mode — как у /generate) и возвращает JSON-метрики: число строк и уникальных, формы, распределения SEARCH / хвостов DV / длин, NID-классы и булевы проверки (aec_prefix, strp_prefix, nid_prefix, dv_search_coupling, triple_lock).

curl -H "X-Api-Token: ВАШ_ТОКЕН" \
  "https://g.topfingers.online/stats?n=1000&seed=1"

Что воспроизводится

три формы строк и фиксированный порядок ключей (основная / +GAE / старая);
префиксы и общие заголовки AEC, NID, __Secure-STRP;
классы NID с длинами protobuf; 8 значений SEARCH_SAMESITE;
связка «хвост DV ↔ код SEARCH», строение DV (23 байта, байт 22 = 26);
тройная сцепка AEC+NID+STRP; дубли целых строк; строки GOOGLE_ABUSE_EXEMPTION.

В режиме exact маржинальные доли совпадают с таблицами разбора.