twogis-service
Внутренний сервис для работы с 2GIS: подсказки адресов, карточка организации, выгрузка отзывов. Ключ 2GIS и обход блокировок живут здесь — проекту нужен только внутренний токен.
- Справочник APIЗапросы, ответы, коды ошибок, список городов, примеры на curl, Python и Java.
- llms.txtВыжимка для LLM: эндпоинты, аутентификация и подводные камни одним файлом.
- OpenAPI 3.1Машинная схема для генерации клиентов.
- MarkdownТот же справочник исходником, если удобнее читать в редакторе.
Endpoints
| Запрос | Назначение |
|---|---|
POST /twogis/address-search | подсказки адресов внутри города |
POST /twogis/apartment | подъезд, этаж и диапазоны квартир |
POST /twogis/place | карточка организации: рейтинг и число отзывов |
POST /twogis/reviews | полная выгрузка отзывов с пагинацией |
POST /twogis/session | живая browser-session Catalog |
POST /twogis/search-pages | браузерный сбор страниц |
POST /twogis/catalog | Catalog, здания и организации |
POST /scrape | запуск parser-2gis с checkpoint и CSV |
GET /status/{run_id} | состояние задания |
GET /rows/{run_id} | поток полученных строк |
GET /result/{run_id} | CSV-результат |
POST /pause/{run_id} | пауза задания |
POST /resume/{run_id} | продолжение задания |
POST /cancel/{run_id} | остановка задания |
GET /health | liveness/readiness, без токена |
Быстрый старт
curl -sS -X POST https://twogis.satushi.me/twogis/address-search \
-H 'Content-Type: application/json' \
-H "X-Internal-Token: $TWOGIS_INTERNAL_TOKEN" \
--data '{"query":"Улы Дала 14","city":"Астана","limit":5}'Токен — в Infisical: проект twogis, env prod, ключ
TWOGIS_INTERNAL_TOKEN. В Kubernetes приезжает через External
Secrets в secret twogis-secrets.