Lukuaika: 5 pöytäkirja
Kalustoalusta
Mobile App

Luo mukautettuja integraatioita
Zeo API:n kanssa

Yhdistä järjestelmäsi Zeoon RESTful-rajapintamme avulla. Luo reittejä,
Seuraa edistymistä reaaliajassa ja automatisoi työnkulkuja webhookien avulla.

Zeo API ja webhookit, Zeo-reittisuunnittelija
  • 99.9%

    API:n käyttöaikaa koskeva palvelutasosopimus

  • 100ms

    Keskimääräinen vasteaika

  • 20+

    API-päätepisteet

  • 10K

    Pyyntöjen/minuuttiraja

Kehittäjäalusta Ominaisuudet

Kaikki mitä tarvitset reittisuunnittelun integroimiseksi sovelluksiisi

  • Zeo API ja webhookit, Zeo-reittisuunnittelija

    REST API

    Täysin varusteltu RESTful-rajapinta reittien, pysäkkien, kuljettajien ja muiden hallintaan. JSON-pyyntö-/vastausmuoto kattavalla dokumentaatiolla.

    • Luo ja optimoi reittejä ohjelmallisesti
    • Hallitse pysäkkejä, kuljettajia ja ajoneuvoja
    • Hae reaaliaikaista seurantadataa
    • Käytä analytiikkaa ja raportteja
    • Joukkotoimintojen tuki
  • Zeo API ja webhookit, Zeo-reittisuunnittelija

    Webhook-tapahtumat

    Reaaliaikaiset tapahtumailmoitukset lähetetään päätepisteisiisi. Reagoi välittömästi reittimuutoksiin, pysähdysten valmistumisiin ja ajuripäivityksiin.

    • Reitin aloitus-/valmistumistapahtumat
    • Lopeta tilanmuutosilmoitukset
    • Kuljettajan sijainnin päivitykset
    • Arvioidun saapumisajan muutoshälytykset
  • Zeo API ja webhookit, Zeo-reittisuunnittelija

    Authentication

    Suojattu API-käyttö alan standardin mukaisella todennuksella. Useita avaintyyppejä eri käyttöoikeustasoille ja käyttötapauksille.

    • Haltijan tunnuksen todennus
    • API-avainten hallinnan kojelauta
    • Avaimeen liittyvät laajuuskohtaiset käyttöoikeudet
    • Avainten kiertotuki
    • Nopeuden rajoitus avainta kohden
  • Zeo API ja webhookit, Zeo-reittisuunnittelija

    Kolmannen osapuolen tuonti

    Tuo tilauksia ja töitä saumattomasti ulkoisista järjestelmistä. Automaattinen osoitteen vahvistus ja geokoodaus tuonnin yhteydessä.

    • Joukkopysäytyksen tuonnin päätepiste
    • Osoitteen validointi ja geokoodaus
    • Mukautettu kenttäkartoitus
    • Päällekkäinen tunnistus
    • Tuonnin tilan seuranta

Verkkokoukku Tapahtumat

Tilaa reaaliaikaiset tapahtumat ja reagoi reittimuutoksiin välittömästi

  • Runko 1707478314 20 1, Zeo-reittisuunnittelija

    reitti.aloitettu

    Käynnistyy, kun kuljettaja aloittaa reitin navigoinnin. Sisältää reittitunnuksen, kuljettajan tiedot ja arvioidun valmistumisajan.

  • Frame 1707478314 19, Zeo Route Planner

    stop.completed

    Käynnistyy, kun pysähdys merkitään suoritetuksi. Sisältää huoltotiedot, aikaleimat ja muistiinpanot.

  • Frame 1707478314 17, Zeo Route Planner

    pysäytys.epäonnistui

    Lähetetään, kun pysähdystä ei voitu suorittaa. Sisältää epäonnistumisen syyn ja mahdolliset otetut valokuvat/muistiinpanot.

  • Ryhmä 11880, Zeo Route Planner

    ajurin.sijainnin_päivitys

    Aktiivisten kuljettajien sijaintitiedot säännöllisesti. Päivitysten tiheys voidaan määrittää 30 sekunnista 5 minuuttiin.

  • Ryhmä 11880 1, Zeo Route Planner

    eta.muuttunut

    Käynnistyy, kun arvioidut saapumisajat muuttuvat merkittävästi liikenteen tai viivästysten vuoksi.

  • Ryhmä 11880 2, Zeo Route Planner

    reitti.valmis

    Käynnistyy, kun kaikki pysähdykset on tehty. Sisältää lopputilastot, keston ja suorituskykymittarit.

  • // Esimerkki Webhook-hyötykuormasta
    {
      "tapahtuma": "stop.completed",
      "aikaleima": "2024-01-15T14:32:00Z",
      "data": {
        "reittitunnus": "reitti_abc123",
        "pysähdystunnus": "stop_xyz789",
        "kuljettaja": {
          "Id": "drv_456",
          "nimi": "John Smith"
        },
        "valmis_kohdassa": "2024-01-15T14:31:45Z",
        "todiste": {
          "allekirjoitus": "https://...",
          "valokuvat": ["https://..."],
          "muistiinpanoja": "Oven taakse jätetty"
        } } }

    API-päätepisteet Yleiskatsaus

    Reittisuunnittelun ja kalustonhallinnan keskeiset päätepisteet

    POST
    /v1/reitit

    Luo uusi reitti pysähdyksillä ja optimointiasetuksilla

    SAA
    /v1/reitit/{id}

    Hae reittitiedot, mukaan lukien optimoitu järjestys

    POST
    /v1/reitit/{id}/optimoi

    Optimoi olemassa oleva reitti uudelleen päivitetyillä parametreilla

    SAA
    /v1/reitit/{id}/seuranta

    Hanki reaaliaikaista seurantatietoa aktiiviselle reitille

    POST
    /v1/pysähdykset/tuonti

    Ulkoisista järjestelmistä tulevien joukkotuontipysähdysten

    PUT
    /v1/stops/{id}/status

    Päivityksen pysäytystila (valmis, epäonnistunut, ohitettu)

    SAA
    /v1/ajurit

    Listaa kaikki kuljettajat saatavuustilanteineen

    SAA
    /v1/ajurit/{id}/sijainti

    Katso nykyinen sijainti ja reitin eteneminen

    POST
    /v1/webhookit

    Rekisteröi webhook-päätepiste tapahtumailmoituksia varten

    Koodi Esimerkit

    Pääset alkuun nopeasti esimerkkien avulla lempikielelläsi



    # Luo ja optimoi reitti useilla pysähdyksillä
    curl -X POST "https://api.zeoroute.com/v1/routes" \ -H "Valtuutus: Haltija $ZEO_API_KEY" \ -H "Sisältötyyppi: application/json" \ -d '{ "name": "Aamutoimitukset", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, Kaupunki" }, "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 } ] }'
    
    # Hae reittitiedot
    curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" \ -H "Valtuutus: Haltija $ZEO_API_KEY"
    
    # Päivitä pysähdyksen tila
    curl -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" \ -H "Valtuutus: Haltija $ZEO_API_KEY" \ -H "Sisältötyyppi: application/json" \ -d '{"status": "valmis", "notes": "Jätetty ovelle"}'

    Integraatio Käytä koteloita

    Automaattiset päivitykset toimivat kaikilla toimialoilla, joilla on aikataulutetut käynnit

    TOIMITUS

    Tilaustenhallinnan integrointi

    Verkkokauppa-alusta tuo automaattisesti uusia tilauksia API:n kautta tunnin välein. Tilaukset ryhmitellään alueittain, optimoidaan reiteille ja lähetetään kuljettajille. Webhook-ilmoitukset päivittävät tilauksen tilan reaaliajassa toimitusten valmistuttua.

    KENTTÄPALVELU

    CRM-pohjainen palveluiden aikataulutus

    Kenttäpalveluyritys synkronoi työtilaukset CRM-järjestelmästään API:n kautta. Uudet työt luovat automaattisesti pysähdyksiä asiakastiedoilla, palveluvaatimuksilla ja aikaikkunoilla. Valmisteluwebhookit päivittävät CRM:n ja käynnistävät laskutuksen.

    Ryhmä 1707478361, Zeo Route Planner

    Valmis rakentamaan Integraatiosi?

    Hanki API-avaimesi ja aloita rakentaminen muutamassa minuutissa kattavan dokumentaatiomme avulla

    Ryhmä 1707478363, Zeo Route Planner

    Zeo-kysely

    Usein
    kysyi
    kysymykset

    Tiedä enemmän

    Zeo API ja webhookit

    Mitkä ovat API-nopeusrajoitukset?

    Tavalliset API-avaimet sallivat 1 000 pyyntöä minuutissa. Yrityspaketit voivat pyytää korkeampia rajoituksia, jopa 10 000 pyyntöä minuutissa. Jokaiseen vastaukseen sisällytetään nopeusrajoitusotsikot, jotta voit seurata käyttöäsi.

    Miten todennan API-pyyntöjä?

    Kaikki API-pyynnöt vaativat Bearer-tokenin Authorization-otsikossa. Voit luoda API-avaimia tilisi asetuksista. Avaimille voidaan määrittää tiettyjä käyttöoikeuksia (vain luku, kirjoitus, järjestelmänvalvoja) ja IP-osoitteita.

    Onko teillä SDK:ita eri kielille?

    Tarjoamme virallisia SDK:ita JavaScriptille/Node.js:lle ja Pythonille. Yhteisön ylläpitämiä SDK:ita on saatavilla Rubylle, PHP:lle ja Go:lle. Kaikki SDK:t ovat avoimen lähdekoodin ja saatavilla GitHubissa.

    Miten webhook-uudelleenyritykset toimivat?

    Jos päätepisteesi palauttaa muun kuin 2xx-vastauksen, yritämme uudelleen eksponentiaalisella peruutusajalla: 1 minuutti, 5 minuuttia, 30 minuuttia, 2 tuntia ja 24 tuntia. Viiden epäonnistuneen yrityksen jälkeen webhook merkitään epäonnistuneeksi ja saat ilmoituksen sähköpostitse.

    Onko testausta varten olemassa hiekkalaatikkoympäristöä?

    Kyllä, tarjoamme täyden testiympäristön osoitteessa api-sandbox.zeoroute.com. Testiympäristössä on sama API, mutta testidata ja se on maksuton. Täydellinen kehitys- ja integraatiotestaukseen.

    Onko API saatavilla kaikissa paketeissa?

    Zeo REST API on saatavilla Fleet Management- ja Enterprise-sopimuksissa. Se sisältää täyden reittienhallinnan, pysähdysten hallinnan, kuljettajien hallinnan ja webhook-tuen reaaliaikaisille tapahtumailmoituksille.

    zeo blogit

    Tutustu blogiimme saadaksesi oivaltavia artikkeleita, asiantuntijoiden neuvoja ja inspiroivaa sisältöä, joka pitää sinut ajan tasalla.

    2026 01 23 Kuinka lyhentää tarkastusmatka-aikaa, esittelyssä Zeo Route Planner

    Kuinka lyhentää tarkastusmatka-aikaa kaluston tehokkuuden parantamiseksi

    Lukuaika: 7 pöytäkirjaOpi todistettuja strategioita kalustosi tarkastusmatka-ajan lyhentämiseksi. Optimoi aikataulutus, mobiilikoordinointi ja reititys seisokkikustannusten vähentämiseksi.

    2026 01 23 Useiden allaspalvelureittien hallinta Esittelyssä, Zeo Route Planner

    Kuinka hallita useita allaspalvelureittejä tehokkaasti

    Lukuaika: 8 pöytäkirjaOpi toimiviksi todistettuja strategioita useiden allaspalvelureittien hallintaan, ajo-ajan lyhentämiseen 30 %:lla, väliin jääneiden siivousten poistamiseen ja kannattavan skaalautumiseen uusille alueille.

    Kuinka tulla DoorDash-kuljettajaksi?, Zeo Route Planner

    Miten tulla DoorDash-kuljettajaksi?

    Lukuaika: 4 pöytäkirjaTyössä me kaikki odotamme joustavuutta ja vapautta. Räjähdysmäisesti kasvava keikkatalous on tästä todellinen osoitus.