Tempu di lettura: 5 minuti
Piattaforma di a flotta
App Mobile

Custruisce integrazioni persunalizate
cù l'API Zeo

Cunnette i vostri sistemi à Zeo cù a nostra API RESTful. Crea percorsi,
seguite i progressi in tempu reale è automatizate i flussi di travagliu cù i webhooks.

API è Webhooks Zeo, Pianificatore di percorsi Zeo
  • 99.9%

    SLA di tempu di funziunamentu di l'API

  • 100ms

    Tempu mediu di risposta

  • 20 +

    Punti finali di l'API

  • 10K

    Limite di richieste/minutu

Piattaforma di sviluppatore Features

Tuttu ciò chì avete bisognu per integrà a pianificazione di percorsi in e vostre applicazioni

  • API è Webhooks Zeo, Pianificatore di percorsi Zeo

    REST API

    API RESTful cumpleta per a gestione di percorsi, fermate, cunduttori è assai di più. Formatu di dumanda/risposta JSON cù documentazione cumpleta.

    • Crea è ottimizza i percorsi programmaticamente
    • Gestisce e fermate, i cunduttori è i veiculi
    • Recuperà dati di tracciamentu in tempu reale
    • Accessu à l'analisi è à i rapporti
    • Supportu per l'operazioni in massa
  • API è Webhooks Zeo, Pianificatore di percorsi Zeo

    Eventi Webhook

    Notificazioni d'eventi in tempu reale mandate à i vostri punti finali. Reagite istantaneamente à i cambiamenti di percorsu, i cumpletamenti di fermate è l'aghjurnamenti di i driver.

    • Eventi di percorsu iniziati/finiti
    • Fermate e notificazioni di cambiamentu di statu
    • Aghjurnamenti di a pusizione di u cunduttore
    • Avvisi di cambiamentu di l'ETA
  • API è Webhooks Zeo, Pianificatore di percorsi Zeo

    prucedimentu

    Accessu API sicuru cù autentificazione standard di l'industria. Parechji tipi di chjave per diversi livelli d'accessu è casi d'usu.

    • Autentificazione di u token di u purtatore
    • Dashboard di gestione di e chjave API
    • Permessi cù scopu per chjave
    • Supportu di rotazione di chjave
    • Limitazione di velocità per chjave
  • API è Webhooks Zeo, Pianificatore di percorsi Zeo

    Impurtazione di terze parti

    Impurtate senza intoppi ordini è travagli da sistemi esterni. Validazione automatica di l'indirizzu è geocodifica à l'impurtazione.

    • Puntu finale di l'importazione di fermata in massa
    • Validazione di l'indirizzu è geocodificazione
    • Mappatura di campi persunalizata
    • Rilevazione duplicata
    • Seguimentu di u statutu di l'impurtazione

Webhook Events

Abbunatevi à l'eventi in tempu reale è reagite subitu à i cambiamenti di percorsu

  • Quadru 1707478314 20 1, Pianificatore di percorsi Zeo

    itinerariu.iniziatu

    Attivatu quandu un cunduttore principia à navigà nantu à un itinerariu. Include l'ID di l'itinerariu, l'infurmazioni di u cunduttore è u tempu di cumpletamentu stimatu.

  • Frame 1707478314 19, Zeo Route Planner

    stop.finitu

    Attivatu quandu una fermata hè marcata cum'è cumpleta. Cuntene dati di prova di serviziu, timestamp è note.

  • Frame 1707478314 17, Zeo Route Planner

    stop.fallitu

    Mandatu quandu una tappa ùn pudia esse cumpletata. Include u mutivu di u fallimentu è qualsiasi foto / note catturate.

  • Gruppu 11880, Zeo Route Planner

    driver.location_update

    Aghjurnamenti periodichi di locu per i cunduttori attivi. Frequenza configurabile da intervalli di 30 secondi à 5 minuti.

  • Gruppu 11880 1, Zeo Route Planner

    eta.cambiatu

    Attivatu quandu l'orari d'arrivu stimati cambianu significativamente per via di u trafficu o di ritardi.

  • Gruppu 11880 2, Zeo Route Planner

    itinerariu cumpletatu

    Attivatu quandu tutte e tappe sò finite. Include statistiche finali, durata è metriche di rendiment.

  • // Esempiu di carica utile Webhook
    {
      "avvenimentu": "stop.finitu",
      "marca temporale": "2024-01-15T14:32:00Z",
      "dati":{
        "id_percorsu": "percorsu_abc123",
        "id_di_fermata": "stop_xyz789",
        "cunduttore":{
          "identificazione": "drv_456",
          nome: "Ghjuvanni Smith"
        },
        "finitu_à": "2024-01-15T14:31:45Z",
        "prova":{
          "firma": "https://...",
          "foto": ["https://..."],
          "note": "À manca à a porta"
        } } }

    Endpoints API Overview

    Punti finali principali per a pianificazione di percorsi è a gestione di a flotta

    POST
    /v1/percorsi

    Crea un novu itinerariu cù tappe è paràmetri d'ottimisazione

    GET
    /v1/percorsi/{id}

    Recuperà i dettagli di a strada, cumprese a sequenza ottimizzata

    POST
    /v1/routes/{id}/ottimisà

    Riottimizà una strada esistente cù parametri aghjurnati

    GET
    /v1/percorsi/{id}/tracciamentu

    Uttene dati di tracciamentu in tempu reale per a strada attiva

    POST
    /v1/stops/import

    L'impurtazione in massa si ferma da sistemi esterni

    Mastru
    /v1/stops/{id}/status

    Aghjurnamentu di u statu di stop (finitu, fiascatu, saltatu)

    GET
    /v1/drivers

    Elencà tutti i cunduttori cù u statutu di dispunibilità

    GET
    /v1/drivers/{id}/locu

    Ottene a pusizione attuale è u prugressu di a strada

    POST
    /v1/webhooks

    Registrà u puntu finale di u webhook per e notificazioni d'eventi

    codice Esempii

    Cuminciate prestu cù esempi in a vostra lingua preferita



    # Crea è ottimizà un itinerariu cù parechje tappe
    arricciatura -X POST "https://api.zeoroute.com/v1/routes" \ -H "Autorizazione: Purtatore $ZEO_API_KEY" \ -H "Tipu di cuntenutu: applicazione/json" \ -d '{ "name": "Consegne di a Mattina", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, City" }, "stops": [ { "address": "456 Customer Ave", "time_window": {"start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "789 Business Blvd", "priority": "high", "service_time": 30 } ] }'
    
    # Ottene i dettagli di a strada
    arricciatura -X GET "https://api.zeoroute.com/v1/routes/route_abc123" \ -H "Autorizazione: Purtatore $ZEO_API_KEY"
    
    # Aghjurnamentu di u statu di stop
    arriccia -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" \ -H "Autorizazione: Purtatore $ZEO_API_KEY" \ -H "Tipu di cuntenutu: applicazione/json" \ -d '{"status": "finitu", "notes": "Lasciatu à a porta"}'

    integrazione Use Cases

    L'aghjurnamenti automatizati funzionanu per qualsiasi industria cù visite pianificate

    DELIVERY

    Integrazione di a Gestione di l'Ordini

    Una piattaforma di e-commerce importa automaticamente novi ordini via API ogni ora. L'ordini sò raggruppati per regione, ottimizzati in percorsi è spediti à i cunduttori. E notifiche Webhook aghjurnanu u statu di l'ordine in tempu reale quandu e consegne sò cumpletate.

    SERVIZIO CAMPU

    Pianificazione di servizii basata nantu à CRM

    Una sucietà di servizii in situ sincronizza l'ordini di travagliu da u so CRM via API. I novi travagli creanu automaticamente fermate cù i dettagli di i clienti, i requisiti di serviziu è e finestre di tempu. I webhook di cumpletamentu aghjurnanu u CRM è attivanu a fatturazione.

    Gruppu 1707478361, Zeo Route Planner

    Pronta à Custruì A vostra integrazione ?

    Uttene a vostra chjave API è cuminciate à custruisce in minuti cù a nostra ducumentazione cumpleta

    Gruppu 1707478363, Zeo Route Planner

    Questionnaire Zeo

    Spessu
    Dumandatu
    Dumande

    Sapete più

    API Zeo è Webhooks

    Chì sò i limiti di velocità di l'API?

    E chjave API standard permettenu 1,000 richieste per minutu. I piani Enterprise ponu dumandà limiti più alti finu à 10,000 richieste per minutu. L'intestazioni di u limite di velocità sò incluse in ogni risposta per pudè seguità u vostru usu.

    Cumu possu autenticà e richieste API?

    Tutte e richieste API necessitanu un token Bearer in l'intestazione di l'autorizazione. Pudete generà chjave API da i paràmetri di u vostru contu. E chjave ponu esse limitate à permessi specifici (sola lettura, scrittura, amministratore) è indirizzi IP.

    Avete SDK per diverse lingue?

    Prupunimu SDK ufficiali per JavaScript/Node.js è Python. I SDK mantenuti da a cumunità sò dispunibili per Ruby, PHP è Go. Tutti i SDK sò open-source è dispunibili nantu à GitHub.

    Cumu funzionanu i tentativi di webhook?

    Sè u vostru endpoint restituisce una risposta micca 2xx, pruvemu di novu cù un backoff esponenziale: 1 minutu, 5 minuti, 30 minuti, 2 ore è 24 ore. Dopu à 5 tentativi falliti, u webhook hè marcatu cum'è fallitu è ​​sarete avvisatu per email.

    Ci hè un ambiente sandbox per i testi?

    Iè, furnimu un ambiente sandbox cumpletu à api-sandbox.zeoroute.com. Sandbox hà a listessa API ma cù dati di prova è senza spese. Perfetta per u sviluppu è i testi d'integrazione.

    L'API hè dispunibule nantu à tutti i piani?

    L'API Zeo REST hè dispunibule nantu à i piani Fleet Management è Enterprise. Include a gestione cumpleta di i percorsi, l'operazioni di fermata, a gestione di i cunduttori è u supportu webhook per e notificazioni di eventi in tempu reale.

    zeo blog

    Esplora u nostru blog per articuli perspicaci, cunsiglii esperti è cuntenutu inspirante chì ti mantene infurmatu.

    2026 01 23 Ottimizazione di a rotta di u serviziu ATM in evidenza, Pianificatore di rotta Zeo

    Ottimizazione di e rotte di u serviziu ATM: Riduce i costi di u 25% in u 2026

    Tempu di lettura: 7 minutiTrasfurmate l'operazioni di serviziu ATM cù l'ottimisazione intelligente di e rotte. Riducete i costi di u 25% mentre migliurate a sicurezza è u tempu di funziunamentu. Soluzioni vere per i gestori.

    2026 01 23 Cumu riduce u tempu di viaghju di l'ispezione In evidenza, Pianificatore di percorsi Zeo

    Cumu riduce u tempu di viaghju d'ispezione per l'efficienza di a flotta

    Tempu di lettura: 7 minutiAmparate strategie pruvate per riduce u tempu di viaghju d'ispezione per a vostra flotta. Ottimizate a pianificazione, a coordinazione mobile è u routing per riduce i costi di i tempi di inattività.

    2026 01 23 Cumu gestisce parechje rotte di serviziu di piscina in evidenza, Pianificatore di rotte Zeo

    Cumu gestisce parechje rotte di serviziu di piscina in modu efficiente

    Tempu di lettura: 8 minutiAmparate strategie pruvate per gestisce parechje rotte di serviziu di piscina, riduce u tempu di guida di 30%, eliminà e pulizie mancate è scalà in modu prufittuosu à nuove zone.