Momento della lettura: 5 verbale
Piattaforma della flotta
mobile App

Crea integrazioni personalizzate
con Zeo API

Collega i tuoi sistemi a Zeo con la nostra API RESTful. Crea percorsi,
monitorare i progressi in tempo reale e automatizzare i flussi di lavoro con i webhook.

API e webhook Zeo, pianificatore di percorsi Zeo
  • 99.9%

    SLA di uptime dell'API

  • 100ms

    Tempo medio di risposta

  • 20+

    Endpoint API

  • 10K

    Limite di richieste/minuto

Piattaforma per sviluppatori Caratteristiche

Tutto ciò che ti serve per integrare la pianificazione del percorso nelle tue applicazioni

  • API e webhook Zeo, pianificatore di percorsi Zeo

    API REST

    API RESTful completa per la gestione di percorsi, fermate, conducenti e altro ancora. Formato richiesta/risposta JSON con documentazione completa.

    • Creare e ottimizzare i percorsi in modo programmatico
    • Gestisci fermate, conducenti e veicoli
    • Recupera dati di tracciamento in tempo reale
    • Accedi ad analisi e report
    • Supporto per operazioni in blocco
  • API e webhook Zeo, pianificatore di percorsi Zeo

    Eventi Webhook

    Notifiche di eventi in tempo reale inviate ai tuoi endpoint. Reagisci immediatamente alle modifiche del percorso, al completamento degli arresti e agli aggiornamenti dei driver.

    • Eventi iniziati/completati del percorso
    • Interrompi le notifiche di modifica dello stato
    • Aggiornamenti sulla posizione del conducente
    • Avvisi di modifica dell'ETA
  • API e webhook Zeo, pianificatore di percorsi Zeo

    Autenticazione

    Accesso API sicuro con autenticazione standard di settore. Diverse tipologie di chiavi per diversi livelli di accesso e casi d'uso.

    • Autenticazione del token portatore
    • Dashboard di gestione delle chiavi API
    • Autorizzazioni con ambito per chiave
    • Supporto per la rotazione delle chiavi
    • Limitazione della velocità per chiave
  • API e webhook Zeo, pianificatore di percorsi Zeo

    Importazione di terze parti

    Importazione fluida di ordini e lavori da sistemi esterni. Convalida automatica degli indirizzi e geocodifica durante l'importazione.

    • Endpoint di importazione di arresto in blocco
    • Validazione dell'indirizzo e geocodifica
    • Mappatura dei campi personalizzati
    • Rilevamento duplicato
    • Monitoraggio dello stato dell'importazione

webhook Eventi

Iscriviti agli eventi in tempo reale e reagisci immediatamente ai cambiamenti di percorso

  • Telaio 1707478314 20 1, Zeo Route Planner

    percorso.iniziato

    Viene attivato quando un conducente inizia a seguire un percorso. Include ID del percorso, informazioni sul conducente e tempo di completamento stimato.

  • Telaio 1707478314 19, Pianificatore di percorso Zeo

    stop.completato

    Si attiva quando una fermata viene contrassegnata come completata. Contiene dati di prova del servizio, timestamp e note.

  • Telaio 1707478314 17, Pianificatore di percorso Zeo

    stop.fallito

    Inviato quando non è stato possibile completare una sosta. Include il motivo dell'errore e tutte le foto/note acquisite.

  • Gruppo 11880, Pianificatore di percorso Zeo

    driver.location_update

    Aggiornamenti periodici della posizione per i conducenti attivi. Frequenza configurabile da intervalli di 30 secondi a 5 minuti.

  • Gruppo 11880 1, Zeo Route Planner

    eta.modificato

    Attivato quando gli orari di arrivo stimati cambiano significativamente a causa del traffico o dei ritardi.

  • Gruppo 11880 2, Zeo Route Planner

    percorso completato

    Si attiva al completamento di tutte le fermate. Include statistiche finali, durata e parametri di performance.

  • // Esempio di payload del webhook
    {
      "evento": "stop.completato",
      "marca temporale": "2024-01-15T14:32:00Z",
      "dati": {
        "route_id": "route_abc123",
        "stop_id": "stop_xyz789",
        "autista": {
          "Id": "drv_456",
          "nome": "Giovanni Smith"
        },
        "completato_alle": "2024-01-15T14:31:45Z",
        "prova": {
          "firma": "https://...",
          "foto": ["https://..."],
          "Appunti": "Lasciato alla porta"
        } } }

    Endpoint API Panoramica

    Endpoint principali per la pianificazione del percorso e la gestione della flotta

    POST
    /v1/percorsi

    Crea un nuovo percorso con fermate e impostazioni di ottimizzazione

    GET
    /v1/percorsi/{id}

    Recupera i dettagli del percorso, inclusa la sequenza ottimizzata

    POST
    /v1/routes/{id}/ottimizza

    Riottimizzare un percorso esistente con parametri aggiornati

    GET
    /v1/routes/{id}/tracciamento

    Ottieni dati di tracciamento in tempo reale per il percorso attivo

    POST
    /v1/arresta/importa

    L'importazione in blocco si interrompe dai sistemi esterni

    PUT
    /v1/ferma/{id}/stato

    Aggiorna lo stato di arresto (completato, fallito, saltato)

    GET
    /v1/driver

    Elenca tutti i driver con stato di disponibilità

    GET
    /v1/driver/{id}/posizione

    Ottieni la posizione attuale e l'avanzamento del percorso

    POST
    /v1/webhook

    Registra l'endpoint del webhook per le notifiche degli eventi

    Code Esempi

    Inizia subito con esempi nella tua lingua preferita



    # Crea e ottimizza un percorso con più fermate
    ricciolo -X POST "https://api.zeoroute.com/v1/routes" \ -H "Autorizzazione: Bearer $ZEO_API_KEY" \ -H "Content-Type: application/json" \ -D '{ "name": "Consegne mattutine", "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 } ] }'
    
    # Ottieni i dettagli del percorso
    curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" \ -H "Autorizzazione: Bearer $ZEO_API_KEY"
    
    # Aggiorna lo stato di arresto
    arricciatura -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" \ -H "Autorizzazione: Bearer $ZEO_API_KEY" \ -H "Content-Type: application/json" \ -D '{"status": "completato", "notes": "Lasciato alla porta"}'

    Integrazione: Casi d'uso

    Gli aggiornamenti automatici funzionano per qualsiasi settore con visite programmate

    CONSEGNA

    Integrazione della gestione degli ordini

    Una piattaforma di e-commerce importa automaticamente nuovi ordini tramite API ogni ora. Gli ordini vengono raggruppati per regione, ottimizzati in base ai percorsi e inviati ai conducenti. Le notifiche webhook aggiornano lo stato dell'ordine in tempo reale al completamento delle consegne.

    SERVIZIO SUL CAMPO

    Pianificazione dei servizi basata su CRM

    Un'azienda di servizi sul campo sincronizza gli ordini di lavoro dal proprio CRM tramite API. I nuovi lavori creano automaticamente fermate con i dettagli del cliente, i requisiti di servizio e le fasce orarie. I webhook di completamento aggiornano il CRM e attivano la fatturazione.

    Gruppo 1707478361, Pianificatore di percorso Zeo

    Pronto per costruire La tua integrazione?

    Ottieni la tua chiave API e inizia a creare in pochi minuti con la nostra documentazione completa

    Gruppo 1707478363, Pianificatore di percorso Zeo

    Questionario Zeo

    Frequentemente
    Chiesto
    Domande

    Per saperne di più

    API e webhook Zeo

    Quali sono i limiti di velocità dell'API?

    Le chiavi API standard consentono 1,000 richieste al minuto. I piani aziendali possono richiedere limiti più elevati, fino a 10,000 richieste al minuto. Le intestazioni dei limiti di velocità sono incluse in ogni risposta, così puoi monitorare il tuo utilizzo.

    Come posso autenticare le richieste API?

    Tutte le richieste API richiedono un token Bearer nell'intestazione Authorization. Puoi generare chiavi API dalle impostazioni del tuo account. Le chiavi possono essere limitate a autorizzazioni specifiche (sola lettura, scrittura, amministratore) e indirizzi IP.

    Sono disponibili SDK per diverse lingue?

    Forniamo SDK ufficiali per JavaScript/Node.js e Python. Sono disponibili SDK gestiti dalla community per Ruby, PHP e Go. Tutti gli SDK sono open source e disponibili su GitHub.

    Come funzionano i nuovi tentativi di webhook?

    Se l'endpoint restituisce una risposta non 2xx, riproviamo con un backoff esponenziale: 1 minuto, 5 minuti, 30 minuti, 2 ore e 24 ore. Dopo 5 tentativi falliti, il webhook viene contrassegnato come non riuscito e riceverai una notifica via email.

    Esiste un ambiente sandbox per i test?

    Sì, forniamo un ambiente sandbox completo su api-sandbox.zeoroute.com. Sandbox ha la stessa API, ma con dati di test e senza costi aggiuntivi. Perfetto per test di sviluppo e integrazione.

    L'API è disponibile su tutti i piani?

    L'API REST di Zeo è disponibile per i piani Fleet Management ed Enterprise. Include la gestione completa dei percorsi, delle fermate, dei conducenti e il supporto webhook per le notifiche degli eventi in tempo reale.

    zeo Blogs

    Esplora il nostro blog per articoli approfonditi, consigli di esperti e contenuti stimolanti che ti tengono informato.

    2026 01 23 Come ridurre i tempi di percorrenza per l'ispezione In primo piano, Zeo Route Planner

    Come ridurre i tempi di percorrenza per l'ispezione per aumentare l'efficienza della flotta

    Momento della lettura: 7 verbaleScopri strategie comprovate per ridurre i tempi di percorrenza per le ispezioni della tua flotta. Ottimizza la pianificazione, il coordinamento dei mezzi mobili e il routing per ridurre i costi di fermo.

    2026 01 23 Come gestire più percorsi di servizio piscina In primo piano, Zeo Route Planner

    Come gestire in modo efficiente più percorsi di servizio piscina

    Momento della lettura: 8 verbaleScopri strategie comprovate per gestire più percorsi di manutenzione della piscina, ridurre i tempi di percorrenza del 30%, eliminare le pulizie saltate e ampliare in modo redditizio nuove aree.

    Come diventare un autista DoorDash?, Zeo Route Planner

    Come diventare un autista DoorDash?

    Momento della lettura: 4 verbaleQuando si tratta di lavoro, ci aspettiamo tutti flessibilità e libertà. L'esplosione dell'economia dei lavoretti occasionali ne è una vera testimonianza.