API для бизнеса

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

Если адрес нужен один, дешевле купить отчёт на сайте — API имеет смысл от сотен адресов.

Один адрес

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

curl -X POST https://walkrate.com/v1/partner/score \
  -H "Authorization: Bearer wk_live_ваш_ключ" \
  -H "content-type: application/json" \
  -d '{"lat": 55.7578, "lon": 37.6126}'

В ответе — балл и то, из чего он сложился:

{
  "id": "KgtsZxMNZqw",
  "address": "Москва, Тверская улица, 6",
  "score": 86.4,
  "band": "Отличная пешая доступность — большинство дел пешком",
  "confidence": 1.0,
  "confidence_label": "высокая",
  "methodology_version": "0.2.0",
  "categories": [
    {
      "key": "daily",
      "title": "Повседневные товары и услуги",
      "score": 100.0,
      "weight": 0.2,
      "places": [
        { "title": "Пятёрочка", "distance_m": 180, "walk_minutes": 2 },
        { "title": "Аптека 36,6", "distance_m": 240, "walk_minutes": 3 }
      ]
    }
  ],
  "warnings": [],
  "attribution": "© OpenStreetMap contributors (ODbL)"
}

Массовый скоринг

Если адресов много, а списки мест не нужны, добавьте ?fields=score. Ответ без перечисления конкретных объектов в десятки раз легче: на выгрузке в тысячи строк это разница между мегабайтами и десятками мегабайт.

Балл, достоверность и все семь категорий остаются и здесь. Отдавать голое число мы не станем: число без объяснения неотличимо от выдуманного, и защищать его перед вашим клиентом будет нечем.

curl -X POST "https://walkrate.com/v1/partner/score?fields=score" \
  -H "Authorization: Bearer wk_live_ваш_ключ" \
  -H "content-type: application/json" \
  -d '{"lat": 55.7578, "lon": 37.6126}'

Список адресов

До тысячи точек за раз. Задача становится в очередь, результат забирается целиком или по мере готовности.

curl -X POST https://walkrate.com/v1/bulk \
  -H "Authorization: Bearer wk_live_ваш_ключ" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: export-2026-08-16" \
  -d '{"points": [
        {"lat": 55.7578, "lon": 37.6126, "id": "flat-10293"},
        {"lat": 59.9343, "lon": 30.3351, "id": "flat-10294"}
      ]}'

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

{
  "id": "9c3f21ab",
  "state": "queued",
  "total": 2,
  "done": 0
}

• Координаты не ищутся заново. Если объект в вашей базе уже разобран до точки, адрес нам не нужен.
• Ваш «id» возвращается как есть — и в ответе, и в выгрузке. Без него склейка идёт по строке адреса, а её мы приводим к своему виду.
• Цена известна до запуска. POST /v1/bulk/estimate с тем же телом скажет, во сколько обойдётся пакет, и ничего не спишет.
• Повторный запрос не удваивает работу. Пришлите тот же Idempotency-Key — получите тот же пакет. Это важно при разрыве связи: вы не знаете, дошёл ли первый запрос, и обязаны повторить.
• Прогресс — GET /v1/bulk/{id}, выгрузка — /result.csv. Строки с ошибками из файла не выбрасываются: вам нужно знать, что именно не посчиталось. Результат живёт неделю.

Сколько стоит

Вы покупаете токены — пакетом и вперёд. Дальше они тратятся внутри сервиса: на расчёт адреса, на сравнение, на изохрону. Что именно считать и в каком порядке, решаете вы, и заранее объявлять это не нужно.

Один запрос — одна цена, независимо от того, считали мы этот адрес раньше. Стоимость выгрузки известна до того, как вы её запустите.

• Адрес или точка5 токенов
• Сравнение5 токенов за адрес
• Изохрона2 токена
• Постановка пакета, опрос прогресса, готовый отчёт по ссылкебесплатно

Подписки нет: токены не сгорают в конце месяца и не требуют выбирать объём заранее на год вперёд. Чем больше пакет, тем дешевле выходит каждый расчёт.

X-Credits-Charged: 5
X-Credits-Balance: 1832

Остаток токенов и списание приходят в заголовках каждого ответа: приближение к нулю видно заранее. Когда оплаченное кончится, придёт 402. Повторять запрос бесполезно, нужно пополнить счёт.

Большие объёмы

От ста тысяч расчётов в месяц работаем по договору: свои гарантии по времени ответа, закрывающие документы и отдельный человек на связи. Напишите на support@walkrate.com, и мы посчитаем под ваш объём.

Ключи

Виджет вместо интеграции

Если балл нужен просто показать — в карточке объявления, в описании ЖК, на странице офиса, — писать код не нужно. Одна строка в HTML, дальше виджет сам подставляет оценку и ведёт на полный разбор. Показывать можно по адресу, по координатам или по коду уже купленного отчёта.

Как встроить виджет

Все методы