VEZOO API do tras i logistyki
Dodaj trasy drogowe, podpowiedzi lokalizacji, geokodowanie i obiekty przy trasie do serwisów, CRM, ERP i dostaw.
Obecny zasięg: Rosja, WNP, Europa, Ameryka Północna i Południowa, Bliski Wschód i Egipt.
OpenAPI 3.1 zawiera parametry, request body, nagłówki, błędy, scopes i przykłady.
Dostęp testowy
Po rejestracji złóż wniosek o dostęp API w koncie dewelopera. Administrator sprawdzi cel, scopes i obciążenie, a następnie klucz pojawi się na Twoim koncie.
Autoryzacja
Przekaż klucz w Authorization: Bearer <api-key>. Klucz można wyłączyć lub obrócić.
Dostęp komercyjny
Dla każdego klienta można ustawić plan, scopes, RPM, quota, datę wygaśnięcia i dozwolone origins.
Szybki start
Pobierz klucz, oblicz trasę i użyj route.polyline do POI oraz inteligentnych postojów.
Jak łączą się metody
Trasa jest bazą. Jej polyline przekazujesz do /places/along-route i /trip-insights.
POST /routeReturns distance, duration, segments and route.polyline.
POST /places/along-routeUse the polyline to fetch roadside objects by category.
POST /trip-insightsUse the same polyline for stop suggestions and smart trip planning.
Metody API
/citiesscope: cities≤ 120 RPMAutocomplete / location search
q: string (2–80, required) · limit: integer (1–20, default 10)/geocodescope: geocode≤ 30 RPMForward and reverse geocoding
q: string OR lat + lon/routescope: route≤ 60 RPMRoad route with up to 12 via points and exclusions
from, to · vias[] / v · exclude: toll,motorway,ferry/places/along-routescope: places≤ 20 RPMFuel, food, lodging, service, tyres, parking and charging
polyline · categories[] (optional)/trip-insightsscope: insights≤ 12 RPMSuggested stops and automatic trip plan
polylineLimity
Obowiązuje niższy z limitu klienta i limitu endpointu. Przekroczenie zwraca HTTP 429.
Scopes
Każdy klucz może mieć dostęp tylko do potrzebnych metod.
citiesroutegeocodeplacesinsightsBrowser origins
Zapytania z przeglądarki można ograniczyć listą dozwolonych Origin.
Gotowe przykłady
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'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 -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"]
}'$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);{
"success": true,
"from": "Москва",
"to": "Казань",
"via": [],
"exclude": [],
"route": {
"kilometers": 817.4,
"minutes": 667,
"polyline": "...",
"segments": [...]
}
}Błędy
Błędy autoryzacji i limitów mają stabilne error_code. Walidacja zwraca HTTP 422.
| HTTP | error_code | Meaning |
|---|---|---|
| 401 | invalid_api_key | Missing or invalid key |
| 401 | api_key_disabled | Key was disabled |
| 401 | api_key_expired | Key expired |
| 403 | scope_forbidden | Scope is not allowed |
| 403 | origin_forbidden | Browser Origin is not allowed |
| 404 | not_found / unknown_location / no_route | Location or route was not found |
| 422 | validation error | Request parameters are invalid |
| 429 | rate_limit_exceeded | Per-minute limit exceeded |
| 429 | quota_exceeded | Total key quota exhausted |
| 503 | api_disabled / api_not_configured | Public API unavailable |
| 503 | service_unavailable | Required routing service unavailable |
Nagłówki odpowiedzi
X-Request-Id służy do wsparcia, a X-RateLimit-* do kontroli ruchu.
X-API-VersionAPI version used for the response
X-Request-IdUnique request identifier for diagnostics
X-RateLimit-LimitEffective requests-per-minute limit
X-RateLimit-RemainingRequests remaining in the current minute
X-Quota-LimitTotal quota when configured for this key
X-Quota-RemainingRemaining total quota
Retry-AfterSeconds before retrying after HTTP 429
Base URL
https://vezoo.ru/api/v1Authentication: Authorization: Bearer YOUR_API_KEY