API et webhooks Zeo | Planificateur d'itinéraires Zeo

Plateforme de développement Caractéristiques

Tout ce dont vous avez besoin pour intégrer la planification d'itinéraires à vos applications

API REST

API RESTful complète pour la gestion des itinéraires, des arrêts, des conducteurs, etc. Format de requête/réponse JSON avec documentation exhaustive.
- Créer et optimiser des itinéraires par programmation
- Gérer les arrêts, les conducteurs et les véhicules
- Récupérer les données de suivi en temps réel
- Accédez aux analyses et aux rapports
- Prise en charge des opérations en masse
Événements Webhook

Notifications d'événements en temps réel envoyées à vos terminaux. Réagissez instantanément aux changements d'itinéraire, aux arrêts terminés et aux mises à jour des conducteurs.
- Événements de départ/arrivée du parcours
- Arrêter les notifications de changement de statut
- Mises à jour de la localisation du chauffeur
- alertes de changement d'ETA
Authentification

Accès API sécurisé avec authentification conforme aux normes du secteur. Plusieurs types de clés pour différents niveaux d'accès et cas d'utilisation.
- Authentification par jeton porteur
- Tableau de bord de gestion des clés API
- Autorisations limitées par clé
- Support de rotation des touches
- Limitation du débit par clé
Importation par un tiers

Importez facilement les commandes et les tâches depuis des systèmes externes. Validation automatique des adresses et géocodage à l'importation.
- point de terminaison d'arrêt d'importation en masse
- Validation d'adresse et géocodage
- Mappage de champs personnalisés
- Détection des doublons
- Suivi de l'état des importations

Webhook Événements

Abonnez-vous aux événements en temps réel et réagissez instantanément aux changements d'itinéraire.

Cadre 1707478314 20 1, Planificateur d'itinéraire Zeo

route.démarrée

Déclenché lorsqu'un conducteur commence à suivre un itinéraire. Comprend l'identifiant de l'itinéraire, les informations sur le conducteur et l'heure d'arrivée estimée.

Cadre 1707478314 19, Planificateur d'itinéraire Zeo

arrêt.terminé

Déclenché lorsqu'un arrêt est marqué comme terminé. Contient des données de preuve de service, des horodatages et des notes.

Cadre 1707478314 17, Planificateur d'itinéraire Zeo

arrêt.échec

Envoyé lorsqu'un arrêt n'a pas pu être effectué. Comprend le motif de l'échec et toutes les photos/notes prises.

Groupe 11880, Planificateur d'itinéraire Zeo

mise à jour de la localisation du conducteur

Mises à jour périodiques de la position des conducteurs actifs. Fréquence configurable de 30 secondes à 5 minutes.

Groupe 11880 1, Planificateur d'itinéraire Zeo

eta.changé

Déclenché lorsque les heures d'arrivée estimées changent sensiblement en raison du trafic ou de retards.

Groupe 11880 2, Planificateur d'itinéraire Zeo

itinéraire terminé

Déclenché une fois toutes les étapes terminées. Inclut les statistiques finales, la durée et les indicateurs de performance.

// Exemple de charge utile de webhook
{
  "un événement": "stop.completed",
  "horodatage": "2024-01-15T14:32:00Z",
  "Les données": {
    "route_id": "route_abc123",
    "stop_id": "stop_xyz789",
    "conducteur": {
      "id": "drv_456",
      "prénom": "John Smith"
    },
    "terminé_à": "2024-01-15T14:31:45Z",
    "preuve": {
      "signature": "https://...",
      "Photos": ["https://..."],
      "Remarques": "Laissé à la porte"
    } } }

Points de terminaison d'API Vue d'ensemble

Points d'accès principaux pour la planification d'itinéraires et la gestion de flotte

POSTEZ

/v1/routes

Créer un nouvel itinéraire avec des arrêts et des paramètres d'optimisation

ÉCONOMISEZ

/v1/routes/{id}

Récupérer les détails de l'itinéraire, y compris la séquence optimisée

POSTEZ

/v1/routes/{id}/optimiser

Réoptimiser un itinéraire existant avec des paramètres mis à jour

ÉCONOMISEZ

/v1/routes/{id}/tracking

Obtenez des données de suivi en temps réel pour votre itinéraire actif.

POSTEZ

/v1/stops/import

L'importation en masse s'arrête à partir de systèmes externes

PUT

/v1/stops/{id}/statut

État de l'arrêt de la mise à jour (terminé, échec, ignoré)

ÉCONOMISEZ

/v1/pilotes

Liste de tous les conducteurs avec statut de disponibilité

ÉCONOMISEZ

/v1/drivers/{id}/location

Obtenir la position actuelle et l'avancement de l'itinéraire

POSTEZ

/v1/webhooks

Enregistrez le point de terminaison webhook pour les notifications d'événements

Code Exemples

Démarrez rapidement avec des exemples dans votre langue préférée

// Créer et optimiser un itinéraire comportant plusieurs arrêts
const créerRoute = async () => {
  const réponse = attendre aller chercher('https://api.zeoroute.com/v1/routes', { méthode: 'PUBLIER', en-têtes : {
      'Autorisation': `Porteur ${process.env.ZEO_API_KEY}`,
      'Type de contenu': 'application/json'
    }, corps : JSON.stringify({ nom : « Livraisons du matin », identifiant_du_conducteur : 'drv_123'optimiser : oui, lieu_départ : { adresse : '123 Warehouse St, City'
      }, arrêts : [ { adresse : '456 Customer Ave', fenêtre_temporelle : { début : '09 00 XNUMX:XNUMX', fin: '12 00 XNUMX:XNUMX' }, temps_de_service : 15
        }, { adresse: '789 Business Blvd', priorité: 'haut', temps_de_service : 30
        } ] }) });

  const route = attendre réponse.json(); console.log('Itinéraire optimisé :', route.séquence_optimisée);
  retourner itinéraire; };

# Créer et optimiser un itinéraire avec plusieurs arrêts
importer demandes
importer clé_API_os = os.environ.get('ZEO_API_KEY') BASE_URL = 'https://api.zeoroute.com/v1'

en-têtes = {
    'Autorisation': f'Porteur {API_KEY}',
    'Type de contenu': 'application/json'
} route_data = {
    'nom': « Livraisons du matin »,
    'driver_id': 'drv_123',
    'optimiser': Vrai,
    'lieu_de_départ': {
        'adresse': '123 Warehouse St, City'
    },
    'arrête': [ {
            'adresse': '456 Customer Ave',
            'fenêtre_temporelle': {'commencer': '09 00 XNUMX:XNUMX', 'fin': '12 00 XNUMX:XNUMX'},
            'temps_de_service': 15
        }, {
            'adresse': '789 Business Blvd',
            'priorité': 'haut',
            'temps_de_service': 30
        } ] } réponse = requests.post(
    f'{URL_BASE}/routes', headers=headers, json=route_data ) route = response.json() print('Itinéraire optimisé :', itinéraire['séquence_optimisée'])

# Créer et optimiser un itinéraire avec plusieurs arrêts
boucle -X POST "https://api.zeoroute.com/v1/routes" -H "Autorisation : Porteur $ZEO_API_KEY" -H « Type de contenu : application/json » \ -d '{ "name": "Livraisons du matin", "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 } ] }'

# Obtenir les détails de l'itinéraire
curl -X OBTENIR "https://api.zeoroute.com/v1/routes/route_abc123" -H "Autorisation : Porteur $ZEO_API_KEY"

# Mise à jour de l'état d'arrêt
boucle -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" -H "Autorisation : Porteur $ZEO_API_KEY" -H « Type de contenu : application/json » \ -d '{"status": "completed", "notes": "Left at door"}'

Intégration : Cas d'usage

Les mises à jour automatisées fonctionnent pour tous les secteurs d'activité avec des visites programmées.

LIVRAISON

Intégration de la gestion des commandes

Une plateforme de commerce électronique importe automatiquement les nouvelles commandes via une API toutes les heures. Les commandes sont regroupées par région, optimisées en itinéraires et attribuées aux livreurs. Des notifications webhook mettent à jour le statut des commandes en temps réel dès la fin des livraisons.

SERVICE SUR LE TERRAIN

Planification des services pilotée par le CRM

Une entreprise de services sur le terrain synchronise les ordres de travail de son CRM via une API. Les nouvelles interventions créent automatiquement des étapes avec les informations client, les besoins de service et les plages horaires. Les webhooks de fin d'intervention mettent à jour le CRM et déclenchent la facturation.