Timp de citit: 5 minute
Platforma flotei
Aplicație Mobilă

Construiți integrări personalizate
cu API-ul Zeo

Conectați-vă sistemele la Zeo cu API-ul nostru RESTful. Creați rute,
urmăriți progresul în timp real și automatizați fluxurile de lucru cu webhook-uri.

API și Webhook-uri Zeo, Planificator de rute Zeo
  • 99.9%

    SLA pentru timpul de funcționare al API-ului

  • 100ms

    Timpul mediu de răspuns

  • 20+

    Puncte finale API

  • 10 K

    Limită de solicitări/minut

Platformă pentru dezvoltatori Categorii

Tot ce ai nevoie pentru a integra planificarea rutelor în aplicațiile tale

  • API și Webhook-uri Zeo, Planificator de rute Zeo

    API-ul REST

    API RESTful complet funcțional pentru gestionarea rutelor, stațiilor, șoferilor și multe altele. Format de cerere/răspuns JSON cu documentație completă.

    • Creați și optimizați rute programatic
    • Gestionați opririle, șoferii și vehiculele
    • Recuperarea datelor de urmărire în timp real
    • Accesați analize și rapoarte
    • Suport pentru operațiuni în bloc
  • API și Webhook-uri Zeo, Planificator de rute Zeo

    Evenimente Webhook

    Notificări de evenimente în timp real trimise către terminalele dvs. Reacționați instantaneu la modificările de rută, completările de opriri și actualizările driverelor.

    • Evenimente de început/finalizare a traseului
    • Notificări de schimbare a stării de oprire
    • Actualizări ale locației șoferului
    • Alerte de modificare a orei estimate de ședere
  • API și Webhook-uri Zeo, Planificator de rute Zeo

    Autentificare

    Acces API securizat cu autentificare standard în industrie. Mai multe tipuri de chei pentru diferite niveluri de acces și cazuri de utilizare.

    • Autentificarea jetonului purtător
    • Tablou de bord pentru gestionarea cheilor API
    • Permisiuni limitate per cheie
    • Suport pentru rotația cheilor
    • Limitarea ratei per cheie
  • API și Webhook-uri Zeo, Planificator de rute Zeo

    Import de la terți

    Importați fără probleme comenzi și lucrări din sisteme externe. Validare automată a adresei și geocodificare la import.

    • Punct final de oprire a importului în bloc
    • Validarea adresei și geocodificarea
    • Mapare personalizată a câmpurilor
    • Detectare duplicat
    • Urmărirea stării importurilor

webhook Evenimente

Abonează-te la evenimente în timp real și reacționează instantaneu la modificările de traseu

  • Cadru 1707478314 20 1, Planificator de rute Zeo

    traseu început

    Se declanșează atunci când un șofer începe să navigheze pe un traseu. Include ID-ul traseului, informațiile șoferului și timpul estimat de finalizare.

  • Cadrul 1707478314 19, Zeo Route Planner

    oprire.completată

    Se declanșează când o oprire este marcată ca finalizată. Conține date de dovadă a serviciului, marcaje temporale și note.

  • Cadrul 1707478314 17, Zeo Route Planner

    stop.failed

    Trimis când o oprire nu a putut fi finalizată. Include motivul eșecului și orice fotografii/note realizate.

  • Grupul 11880, Zeo Route Planner

    driver.location_update

    Actualizări periodice ale locației pentru șoferii activi. Frecvență configurabilă de la intervale de 30 secunde la 5 minute.

  • Grupa 11880 1, Zeo Route Planner

    eta.schimbat

    Se declanșează atunci când orele estimate de sosire se modifică semnificativ din cauza traficului sau a întârzierilor.

  • Grupa 11880 2, Zeo Route Planner

    traseu finalizat

    Se declanșează când toate opririle sunt finalizate. Include statistici finale, durată și valori de performanță.

  • // Exemplu de sarcină utilă Webhook
    {
      "eveniment": "stop.completat",
      "timestamp-ul": "2024-01-15T14:32:00Z",
      "date":{
        "id_rută": "ruta_abc123",
        "id_oprire": „stop_xyz789”,
        „șofer”:{
          „id”: „drv_456”,
          „Nume“: „Ioan Smith”
        },
        "finalizat_la": "2024-01-15T14:31:45Z",
        „dovadă”:{
          "semnătură": „https://...”,
          „fotografii”: [„https://...”],
          "note": "Stânga la ușă"
        } } }

    Puncte finale API Descriere

    Puncte finale principale pentru planificarea rutelor și gestionarea flotei

    POST
    /v1/rute

    Creați un traseu nou cu opriri și setări de optimizare

    GET
    /v1/rute/{id}

    Preluarea detaliilor rutei, inclusiv a secvenței optimizate

    POST
    /v1/routes/{id}/optimize

    Reoptimizarea unei rute existente cu parametri actualizați

    GET
    /v1/rute/{id}/urmărire

    Obțineți date de urmărire în timp real pentru ruta activă

    POST
    /v1/oprește/import

    Importul în bloc se oprește din sisteme externe

    PUT
    /v1/stops/{id}/stare

    Actualizare stare oprire (finalizată, eșuată, omisă)

    GET
    /v1/drivere

    Enumerați toți driverele cu starea de disponibilitate

    GET
    /v1/drivere/{id}/locație

    Obțineți locația actuală și progresul traseului

    POST
    /v1/webhooks

    Înregistrați punctul final webhook pentru notificări de evenimente

    Cod Exemple

    Începeți rapid cu exemple în limba dvs. preferată



    # Creați și optimizați un traseu cu mai multe opriri
    curl -X POST „https://api.zeoroute.com/v1/routes” \ -H „Autorizație: Purtător $ZEO_API_KEY” \ -H „Tip de conținut: aplicație/json” \ -d '{ "name": "Livrări de dimineață", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "Strada Warehouse nr. 123, Oraș" }, "stops": [ { "address": "Strada Clientului nr. 456", "time_window": {"start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "Bulevardul Business nr. 789", "priority": "high", "service_time": 30 } ] }'
    
    # Obțineți detalii despre traseu
    curl -X GET „https://api.zeoroute.com/v1/routes/route_abc123” \ -H „Autorizație: Purtător $ZEO_API_KEY”
    
    # Actualizați starea opririi
    curl -X PUNE „https://api.zeoroute.com/v1/stops/stop_xyz789/status” \ -H „Autorizație: Purtător $ZEO_API_KEY” \ -H „Tip de conținut: aplicație/json” \ -d '{"status": "finalizat", "note": "Lăsat la ușă"}'

    Integrare Utilizați cazuri

    Actualizările automate funcționează pentru orice industrie cu vizite programate

    DE CURIERAT

    Integrarea managementului comenzilor

    O platformă de comerț electronic importă automat comenzi noi prin API în fiecare oră. Comenzile sunt grupate pe regiuni, optimizate pe rute și expediate către șoferi. Notificările Webhook actualizează starea comenzii în timp real, pe măsură ce livrările sunt finalizate.

    MUNCA DE TEREN

    Programarea serviciilor bazată pe CRM

    O companie de servicii pe teren sincronizează comenzile de lucru din CRM-ul său prin intermediul API-ului. Noile lucrări creează automat opriri cu detalii despre clienți, cerințe de service și ferestre de timp. Webhook-urile de finalizare actualizează CRM-ul și declanșează facturarea.

    Grupul 1707478361, Zeo Route Planner

    Gata de Construit Integrarea dumneavoastră?

    Obțineți cheia API și începeți să construiți în câteva minute cu ajutorul documentației noastre complete

    Grupul 1707478363, Zeo Route Planner

    Chestionarul Zeo

    Frecvent
    Întrebat
    Întrebări

    Aflați mai multe

    API-ul Zeo și Webhook-urile

    Care sunt limitele de rată API?

    Cheile API standard permit 1,000 de solicitări pe minut. Planurile Enterprise pot solicita limite mai mari, de până la 10,000 de solicitări pe minut. Anteturile limitei de viteză sunt incluse în fiecare răspuns, astfel încât să puteți urmări utilizarea.

    Cum autentific cererile API?

    Toate cererile API necesită un token Bearer în antetul de autorizare. Puteți genera chei API din setările contului dvs. Cheile pot fi definite pentru permisiuni specifice (doar citire, scriere, administrator) și adrese IP.

    Aveți SDK-uri pentru diferite limbi?

    Oferim SDK-uri oficiale pentru JavaScript/Node.js și Python. SDK-uri întreținute de comunitate sunt disponibile pentru Ruby, PHP și Go. Toate SDK-urile sunt open-source și disponibile pe GitHub.

    Cum funcționează reîncercările webhook?

    Dacă endpoint-ul returnează un răspuns diferit de 2xx, vom reîncerca cu o perioadă de așteptare exponențială: 1 minut, 5 minute, 30 de minute, 2 ore și 24 de ore. După 5 încercări eșuate, webhook-ul este marcat ca eșuat și veți fi notificat prin e-mail.

    Există un mediu sandbox pentru testare?

    Da, oferim un mediu sandbox complet la api-sandbox.zeoroute.com. Sandbox are aceeași API, dar cu date de testare și fără costuri. Perfect pentru dezvoltare și testare a integrării.

    Este API-ul disponibil pentru toate planurile?

    API-ul Zeo REST este disponibil pentru planurile Fleet Management și Enterprise. Acesta include gestionarea completă a rutelor, operațiuni de oprire, gestionarea șoferilor și suport webhook pentru notificări de evenimente în timp real.

    Zeo bloguri

    Explorează blogul nostru pentru articole perspicace, sfaturi ale experților și conținut inspirat care te ține la curent.

    2026 01 23 Optimizare rută serviciu ATM Recomandat, Planificator rută Zeo

    Optimizarea rutelor de servicii ATM: Reducerea costurilor cu 25% în 2026

    Timp de citit: 7 minuteTransformați operațiunile serviciilor ATM cu optimizarea inteligentă a rutelor. Reduceți costurile cu 25%, îmbunătățind în același timp securitatea și timpul de funcționare. Soluții reale pentru manageri.

    2026 01 23 Cum să reduci timpul de călătorie pentru inspecție Recomandat, Planificator de rute Zeo

    Cum să reduci timpul de călătorie pentru inspecție pentru eficiența flotei

    Timp de citit: 7 minuteÎnvățați strategii dovedite pentru a reduce timpul de călătorie pentru inspecția flotei dvs. Optimizați programarea, coordonarea mobilă și rutarea pentru a reduce costurile timpilor de nefuncționare.

    2026 01 23 Cum să gestionați mai multe rute de servicii Pool Recomandat, Planificator de rute Zeo

    Cum să gestionezi eficient mai multe rute de servicii pentru pool-uri

    Timp de citit: 8 minuteÎnvățați strategii dovedite pentru a gestiona mai multe rute de service pentru piscine, a reduce timpul de condus cu 30%, a elimina curățările ratate și a vă extinde în mod profitabil în zone noi.