VEZOO Public API v1

VEZOO API für Routing und Logistik

Integrieren Sie Straßenrouten, Ortssuche, Geocoding und POIs entlang der Route in Websites, CRM, ERP und Lieferdienste.

Aktuelle Abdeckung: Russland, GUS, Europa, Nord- und Südamerika sowie der Nahe Osten und Ägypten.

OpenAPI 3.1 enthält Parameter, Request Bodies, Response-Header, Fehlercodes, Scopes und Beispiele.

Testzugang

Nach der Registrierung beantragen Sie den API-Zugang im Entwicklerkonto. Der Administrator prüft Zweck, Scopes und Last; danach erscheint der Schlüssel in Ihrem Konto.

Authentifizierung

Schlüssel als Authorization: Bearer <api-key> senden. Schlüssel können deaktiviert oder rotiert werden.

Kommerzieller Zugang

Plan, Scopes, RPM, Kontingent, Ablaufdatum und erlaubte Browser-Origins können pro Kunde gesetzt werden.

Schnellstart

Schlüssel erhalten, Route berechnen und route.polyline für POIs und intelligente Stopps verwenden.

1
Zugang anfragen
Authorization: Bearer <api-key>
2
POST /route
from + to + optional vias
3
route.polyline
Use the returned encoded polyline
4
POI / insights
Pass polyline to trip endpoints

Zusammenspiel der Methoden

Die Route ist die Basis. Ihre Polyline wird an /places/along-route und /trip-insights übergeben.

STEP 1
POST /route

Returns distance, duration, segments and route.polyline.

STEP 2
POST /places/along-route

Use the polyline to fetch roadside objects by category.

STEP 3
POST /trip-insights

Use the same polyline for stop suggestions and smart trip planning.

API-Methoden

GET/citiesscope: cities≤ 120 RPM

Autocomplete / location search

Parameter
q: string (2–80, required) · limit: integer (1–20, default 10)
GET/geocodescope: geocode≤ 30 RPM

Forward and reverse geocoding

Parameter
q: string OR lat + lon
GET | POST/routescope: route≤ 60 RPM

Road route with up to 12 via points and exclusions

Parameter
from, to · vias[] / v · exclude: toll,motorway,ferry
POST/places/along-routescope: places≤ 20 RPM

Fuel, food, lodging, service, tyres, parking and charging

Parameter
polyline · categories[] (optional)
POST/trip-insightsscope: insights≤ 12 RPM

Suggested stops and automatic trip plan

Parameter
polyline

Limits

Es gilt der kleinere Wert aus Client-Limit und Endpoint-Limit. Überschreitungen liefern HTTP 429.

cities 120 · route 60 · geocode 30 · places 20 · insights 12 RPM

Scopes

Jeder Schlüssel kann auf die tatsächlich benötigten Methoden beschränkt werden.

citiesroutegeocodeplacesinsights

Browser-Origins

Browser-Anfragen können auf erlaubte Origin-Werte begrenzt werden.

Fertige Beispiele

cURL · route
curl -G 'https://vezoo.ru/api/v1/route' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'from=Москва' \
  --data-urlencode 'to=Казань' \
  --data-urlencode 'v=Владимир' \
  --data-urlencode 'exclude=ferry'
JavaScript · route
const response = await fetch('https://vezoo.ru/api/v1/route', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: 'Москва',
    to: 'Казань',
    vias: ['Владимир'],
    exclude: ['ferry'],
  }),
});
const data = await response.json();
console.log(data.route.polyline);
cURL · places along route
curl -X POST 'https://vezoo.ru/api/v1/places/along-route' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "polyline":"ENCODED_POLYLINE_FROM_ROUTE",
    "categories":["fuel","food","lodging","parking","charging"]
  }'
PHP · route
$payload = json_encode([
    'from' => 'Москва',
    'to' => 'Казань',
]);
$ch = curl_init('https://vezoo.ru/api/v1/route');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
JSON · route response
{
  "success": true,
  "from": "Москва",
  "to": "Казань",
  "via": [],
  "exclude": [],
  "route": {
    "kilometers": 817.4,
    "minutes": 667,
    "polyline": "...",
    "segments": [...]
  }
}

Fehler

Authentifizierungs- und Limitfehler liefern stabile error_code-Werte. Validierungsfehler verwenden HTTP 422.

HTTPerror_codeMeaning
401invalid_api_keyMissing or invalid key
401api_key_disabledKey was disabled
401api_key_expiredKey expired
403scope_forbiddenScope is not allowed
403origin_forbiddenBrowser Origin is not allowed
404not_found / unknown_location / no_routeLocation or route was not found
422validation errorRequest parameters are invalid
429rate_limit_exceededPer-minute limit exceeded
429quota_exceededTotal key quota exhausted
503api_disabled / api_not_configuredPublic API unavailable
503service_unavailableRequired routing service unavailable

Response-Header

X-Request-Id für Support und X-RateLimit-* zur Lastkontrolle verwenden.

X-API-Version

API version used for the response

X-Request-Id

Unique request identifier for diagnostics

X-RateLimit-Limit

Effective requests-per-minute limit

X-RateLimit-Remaining

Requests remaining in the current minute

X-Quota-Limit

Total quota when configured for this key

X-Quota-Remaining

Remaining total quota

Retry-After

Seconds before retrying after HTTP 429

Base URL

https://vezoo.ru/api/v1

Authentication: Authorization: Bearer YOUR_API_KEY