Aller au contenu principal

Get available deliveries for GPS tracking

GET 
/truckers/deliveries/trackable

Cet endpoint renvoie une liste de livraisons en cours qui peuvent être suivies en temps réel via GPS.

Caractéristiques principales :

  • Inclut uniquement les livraisons avec le statut 'collected' (collectées mais non livrées)
  • Exclut les livraisons associées à des enchères
  • Fournit les informations essentielles pour le suivi :
    • Code de service unique
    • Statut actuel de la livraison
    • Adresses complètes de chargement (ETL) et de déchargement (ETD)
    • Coordonnées géographiques si disponibles
    • Dernière position connue du véhicule (si disponible)

Cas d'utilisation typiques :

  • Visualiser toutes les livraisons actives sur la carte du transporteur
  • Sélectionner une livraison spécifique pour démarrer le suivi GPS
  • Vérifier quelles livraisons sont actuellement en route
  • Planifier des itinéraires multiples lorsqu'il y a plusieurs livraisons actives
  • Surveiller la progression des livraisons en cours

Validations et restrictions :

  • Nécessite une authentification JWT valide de transporteur
  • Affiche uniquement les livraisons assignées au transporteur authentifié
  • Les livraisons doivent avoir le statut 'collected' pour apparaître
  • N'inclut pas les livraisons terminées ou annulées
  • Fréquence de requête maximale : 1 fois par minute

Exemple de flux :

  1. Le transporteur se connecte à l'application mobile
  2. L'application interroge cet endpoint périodiquement (toutes les 2-5 minutes)
  3. Les livraisons actives sont affichées sur la carte avec leur dernière position
  4. Le transporteur en sélectionne une pour démarrer un suivi détaillé

Notes techniques :

  • Les coordonnées sont renvoyées au format [longitude, latitude] (GeoJSON)
  • Le statut 'collected' indique que la cargaison a été collectée mais non livrée
  • Les adresses incluent la ville, le code postal et la province
  • La réponse inclut l'en-tête X-Total-Count avec

Request​

Responses​

Liste des livraisons disponibles pour suivi GPS

Response Headers
    X-Total-Count

    Nombre total de livraisons traçables

    Example: 2
    X-RateLimit-Remaining

    Nombre de requêtes restantes dans la période actuelle

    Example: 58